|
|
| (26 intermediate revisions by 7 users not shown) |
| Line 1: |
Line 1: |
| − | {{ScoutPage|cat=Release 3.10}}
| + | The Scout documentation has been moved to https://eclipsescout.github.io/. |
| − | | + | |
| − | This page shows what you need to know about the new Eclipse [[Scout/Release/Luna | Scout 3.10]] release shipped with Eclipse [[Luna]].
| + | |
| − | | + | |
| − | == M1 (Friday, August 23, 2013) ==
| + | |
| − | | + | |
| − | === Scout is using GIT flow ===
| + | |
| − | {{Bug|411769}}
| + | |
| − | | + | |
| − | Scout is now using GIT flow with 3.10 as described [[Scout/Contribution_Guidelines | here]]. We also try to make contributions more efficient and update our [[Scout/Contributions_for_Scout_Committers | documentation for committers]]
| + | |
| − | | + | |
| − | === New french translations for ScoutTexts ===
| + | |
| − | {{Bug|414392}} - New translations were added for the French language (ScoutTexts entries for fr and fr_BE).
| + | |
| − | | + | |
| − | There is one minor correction for the fr_BE language. Additionally 14 translations were added to the French language (missing until now). These translations will be used in all Scout applications deployed in French, unless the text entry is overridden in the project.
| + | |
| − | | + | |
| − | === Tree Box with support for auto check of child nodes ===
| + | |
| − | | + | |
| − | {{Bug|368107}}
| + | |
| − | | + | |
| − | A a new configuration method for the treebox was introduced to automatically check/uncheck all child nodes when the parent node is checked / unchecked: AbstractTreeBox now provides getConfiguredAutoCheckChildNodes.
| + | |
| − | | + | |
| − | [[File:ScoutTreeboxExample.png]]
| + | |
| − | | + | |
| − | === Scout SDK: Tooling Functionality for F2 ===
| + | |
| − | {{Bug|409468}}
| + | |
| − | | + | |
| − | [[Scout/Concepts/F2 | F2]] is a simple update manager for Eclipse or Java based applications that can be downloaded from the [http://marketplace.eclipse.org/content/f2-updater eclipse marketplace]. Scout SDK provides a new technology checkbox to help integrating F2 into your Scout application. A tutorial is provided [[Scout/Tutorial/3.10/UpdateWithF2 | here]].
| + | |
| − | | + | |
| − | [[Image:addF2SupportToScoutApplication.jpg|400px]]
| + | |
| − | | + | |
| − | | + | |
| − | === Scout SDK: Eclipse 3.6 not supported anymore ===
| + | |
| − | Scout SDK does not run with Eclipse 3.6 anymore. Scout Runtime is still compatible to eclipse 3.6. Please upgrade your eclipse IDE! See [[Scout/Release/Luna#Target_Environment | here]] for supported eclipse versions.
| + | |
| − | | + | |
| − | == M2 (Friday, October 04) ==
| + | |
| − | | + | |
| − | === Swing: Custom XML for Rayo Look and Feel ===
| + | |
| − | {{Bug|417579}} and {{Bug|408611}}:
| + | |
| − | There is an addition in the Scout RT Swing API allowing to provide a custom configuration for Look and Feels. This new extension point is used by Rayo: it is now possible to exchange the XML (e.g. to use different colors). See {{ScoutLink|Concepts|Rayo#Use_a_custom_XML|Use a custom XML with the Rayo Look and Feel}}.
| + | |
| − | | + | |
| − | === Minor API Enhancements ===
| + | |
| − | {{Bug|416848}} ServiceTunnelServlet
| + | |
| − | | + | |
| − | {{Bug|416862}} Scheduler
| + | |
| − | | + | |
| − | === Enhancement of SWT look and feel extension point ===
| + | |
| − | {{Bug|407261}} The Look and Feel extension point for SWT now has a new property for setting the background color of disabled fields (color.background.disabled). Setting the foreground color of disabled fields (color.forground.disabled) has already been available.
| + | |
| − | | + | |
| − | [[Image:Swtlookandfeelextensionpoint.PNG|600px]]
| + | |
| − | | + | |
| − | | + | |
| − | === SDK: Test Suite and CBI ===
| + | |
| − | {{Bug|397542}} We have added the possibility to run the SDK Test suite from our maven Build. Because these tests require an UI Layer, they are not activated by default (analog to our UiTests in the RT). To activate them, run the build with the profile <tt>include-sdktest</tt>.
| + | |
| − | | + | |
| − | mvn clean install -Pinclude-sdktest
| + | |
| − | | + | |
| − | Sidenote: for the moment we have some tests failing. This is probably due to a discrepancy between running tests from eclipse and running test from maven. We will work on this.
| + | |
| − | | + | |
| − | == M3 (Friday, November 15) ==
| + | |
| − | | + | |
| − | === Service tunnel plugin ===
| + | |
| − | With bug {{Bug|405353}}, we have introduced a new plugin: <tt>org.eclipse.scout.rt.servicetunnel</tt>
| + | |
| − | | + | |
| − | This plugin contains the classes handling the service tunnel (client-server {{ScoutLink|Concepts|Communication|communication}}) that were previously contained in the <tt>org.eclipse.scout.rt.client plugin</tt>. As a result the client plugin has a dependency on the new servicetunnel plugin. If you work with plugin based product file (every project created by the Scout SDK does) you should add the new plugin as new dependency in your client product files. The [https://bugs.eclipse.org/bugs/show_bug.cgi?id=405353#c5 migration notes] in bugzilla contained additional information that will help you to fix the depreciation warnings.
| + | |
| − | | + | |
| − | The service tunnel classes are now independent from the client. This allows, for example to reuse this bundle in the server application to do server-server instead of client-server communication.
| + | |
| − | | + | |
| − | [[Image:Scout_Servicetunnel_Class_Diagram.png|thumb|right|200px|Scout service tunnel classes.]]
| + | |
| − | | + | |
| − | In the client plugin you should now consider {{ScoutJavadoc|IClientServiceTunnel|I}} and {{ScoutJavadoc|ClientServiceTunnel|C}} when you want to extend the service tunnel mechanism.
| + | |
| − | | + | |
| − | In the service tunnel plugin, the architecture has also evolved: <tt>HttpBackgroundJob</tt> does not exist anymore. Instead there are {{ScoutJavadoc|HttpBackgroundExecutable|C}} (runnable which is executed by a Job) and {{ScoutJavadoc|HttpBackgroundExecutor|C}} (composite which holds a Job and an HttpBackgroundExecutable together). In the service tunnel plugin, you will also find the abstract classes you can extend for you own use case (for example {{ScoutJavadoc|AbstractHttpServiceTunnel<T extends ISession>|C}} can be used as parent class for a <tt>ServerHttpServiceTunnel</tt>).
| + | |
| − | | + | |
| − | | + | |
| − | === TablePageData Dto ===
| + | |
| − | {{Bug|412752}} introduced a new type of transfert object for {{ScoutLink|Concepts|TablePage}}: the {{ScoutLink|Concepts|TablePageData}} objects. Similar to {{ScoutLink|Concepts|FormData}} it contains the content of the page that comes from the server to the client. Like for the FormData the PageData is linked with the {{ScoutJavadoc|PageData|A}} annotation:
| + | |
| − | | + | |
| − | <source lang="java">
| + | |
| − | @PageData(PersonTablePageData.class)
| + | |
| − | public class PersonTablePage extends AbstractPageWithTable<Table> {
| + | |
| − | //... content of the page
| + | |
| − | }
| + | |
| − | </source>
| + | |
| − | | + | |
| − | {{Bug|419138}}: in the client plugin-in, in the {{ScoutEvent|LoadData}} event (new event that replace {{ScoutEvent|LoadTableData}}) it is possible to import the pageData:
| + | |
| − | <source lang="java">
| + | |
| − | @Override
| + | |
| − | protected void execLoadData(SearchFilter filter) throws ProcessingException {
| + | |
| − | PersonSearchFormData formData = (PersonSearchFormData) filter.getFormData();
| + | |
| − | if (formData == null) {
| + | |
| − | formData = new PersonSearchFormData();
| + | |
| − | }
| + | |
| − | | + | |
| − | PersonTablePageData pageData = SERVICES.getService(IStandardOutlineService.class).getPersonTableData(formData);
| + | |
| − | importPageData(pageData);
| + | |
| − | }
| + | |
| − | </source>
| + | |
| − | | + | |
| − | {{Bug|419140}}: the {{ScoutLink|Concepts|Sql_Service|SQL Support}} of Scout also offer support to select into TablePage data. For example:
| + | |
| − | | + | |
| − | <source lang="java">SQL.selectInto("SELECT person_nr, last_name, first_name FROM person INTO :{personNr}, :{lastName}, :{firstName}", pageData);</source>
| + | |
| − | | + | |
| − | For your table field, if you decide to switch your {{ScoutLink|Concepts|TableData}} from array based table data to bean based table data, the SQL support provides you the same possibilites (holder, input bind, output bind, filter...).
| + | |
| − | | + | |
| − | {{Bug|418997}}: the SDK was modified to take care of this modification. When a new Table page is generated, the SDK can also generate the corresponding TablePageData.
| + | |
| − | | + | |
| − | === ClientNotification - SingleUserFilter ===
| + | |
| − | With {{Bug|408551}}, the default value of SingleUserFilter's <b>isMulticast</b> was changed from <b>false</b> to <b>true</b>.
| + | |
| − | | + | |
| − | === Menu Mnemonics for SWT ===
| + | |
| − | With {{Bug|419831}}, mnemonics for menus are working with SWT. When declaring a menu with an ampersand (e.g. "&File") the "F" character gets underlined. When pressing "alt+F", the menu will be selected.
| + | |
| − | | + | |
| − | === Upgrade to org.apache.batik 1.7 in Scout RT Feature ===
| + | |
| − | With {{Bug|421217}} scout upgrades org.apache.batik from 1.6 to 1.7. This is because batik was upgraded in the platform (see [[http://download.eclipse.org/eclipse/downloads/drops4/S-4.4M3-201310302000/news/#Platform]]. The dependencies in the scout plugins remain the same (still compatible with batik 1.6), however the default installed version when creating a new project is batik 1.7.
| + | |
| − | | + | |
| − | == M4 (planned: Friday, December 20) ==
| + | |
| − | | + | |
| − | === Removal of Legacy Functionality ===
| + | |
| − | | + | |
| − | * With {{Bug|421586}} Deprecated Code for 3.10 will be removed
| + | |
| − | * With {{Bug|422055}} The Legacy Text Fragment is removed
| + | |
| − | * With {{Bug|422052}} Legacy SQL Support in Scout Client will be removed in the next release (Scout 3.11)
| + | |
| − | * With {{Bug|403310}} Scout Client Testing Framework will be removed (To be replaced with junit based integration tests)
| + | |
| − | | + | |
| − | === Generics in ICodeType, ICode, ILookupRow, ILookupService, ICodeRow ===
| + | |
| − | | + | |
| − | With {{Bug|420491}} several JRE 1.3 relevant code will be replaced with JRE 1.6+ implementations.
| + | |
| − | | + | |
| − | ICodeType, ICode, ILookupRow, ILookupService, ICodeRow and all its implementations become generic.
| + | |
| − | Several (return-) parameters will be changed from array to typed lists.
| + | |
| − | SmartFields allowing custom text become its own field ‘ProposalField’. Sot the ‘allowCustomText’ member will be removed from ISmartField. The lookupCall and codeType members on IContentAssistField (common super class of ISmartField and IProposalField) will be typed.
| + | |
| − | | + | |
| − | === Multiline Support for RadioButton and CheckBox ===
| + | |
| − | With {{Bug|419011}} and {{Bug|419015}} RadioButton and CheckBox now support multiline labels. Try it via
| + | |
| − | <source lang="java">
| + | |
| − | public class MultilineCheckboxField extends AbstractCheckBox {
| + | |
| − | | + | |
| − | @Override
| + | |
| − | protected String getConfiguredLabel() {
| + | |
| − | return "This is a \n multiline \n checkbox";
| + | |
| − | }
| + | |
| − | | + | |
| − | @Override
| + | |
| − | protected int getConfiguredGridH() {
| + | |
| − | return 2;
| + | |
| − | }
| + | |
| − | }
| + | |
| − | </source>
| + | |
| − | | + | |
| − | === Number Fields ===
| + | |
| − | Together with {{Bug|422120}}, {{Bug|422160}} and {{Bug|422163}} were solved. In addition to the reported problems with integer number fields, similar issues were fixed for the decimal number fields. Further problems with these number fields were fixed and the API was consolidated.
| + | |
| − | | + | |
| − | Consider these changes for migration:
| + | |
| − | | + | |
| − | ''Consistent Rounding''
| + | |
| − | * There is a new property '''roundingMode''' for all number fields which is used for formatting and parsing. When set to ROUND_UNNECESSARY the parsing of GUI-text-input accepts only values that can be assigned without rounding to the field's generic type and respect the maxFractionDigits property for decimal number fields. (Old parsing behavior was: truncating for AbstractIntegerField and AbstractLongField; rounding for decimal number fields; exception for AbstractBigIntegerField for fraction digits.) Default is ROUND_UNNECESSARY for integer number fields and ROUND_EVEN for decimal number fields.
| + | |
| − | ''Consistent API Names''
| + | |
| − | * AbstractNumberField.createNumberFormat() is deprecated, use createDecimalFormat() instead
| + | |
| − | * AbstractDecimalField.createNumberFormat() is deprecated, use createDecimalFormat() instead
| + | |
| − | * AbstractDoubleField.getConfiguredMinimumValue() is deprecated, use getConfiguredMinValue() instead
| + | |
| − | * AbstractDoubleField.getConfiguredMaximumValue() is deprecated, use getConfiguredMaxValue() instead
| + | |
| − | * AbstractIntegerField.getConfiguredMinimumValue() is deprecated, use getConfiguredMinValue() instead
| + | |
| − | * AbstractIntegerField.getConfiguredMaximumValue() is deprecated, use getConfiguredMaxValue() instead
| + | |
| − | * AbstractLongField.getConfiguredMinimumValue() is deprecated, use getConfiguredMinValue() instead
| + | |
| − | * AbstractLongField.getConfiguredMaximumValue() is deprecated, use getConfiguredMaxValue() instead
| + | |
| − | * Return value of AbstractBigDecimalField.getConfiguredMinValue() changed from Double to BigDecimal (For overrides it is recommended to use BigDecimal's String-constructor.)
| + | |
| − | * Return value of AbstractBigDecimalField.getConfiguredMaxValue() changed from Double to BigDecimal (For overrides it is recommended to use BigDecimal's String constructor.)
| + | |
| − | * Return value of AbstractBigIntegerField.getConfiguredMinValue() changed from Long to BigInteger (For overrides it is recommended to use BigInteger's String constructor.)
| + | |
| − | * Return value of AbstractBigIntegerField.getConfiguredMaxValue() changed from Long to BigInteger (For overrides it is recommended to use BigInteger's String constructor.)
| + | |
| − | ''Character limit in UI''
| + | |
| − | * The fix character limit (60 chars swing, 32 chars SWT and RAP) for all number fields was replaced by a default for AbstractNumberField.getConfiguredMaxValue() and AbstractNumberField.getConfiguredMinValue(). These defaults are set to the limits of the generic type where such a limit exists and +-999999999999999999999999999999999999999999999999999999999999 for AbstractBigIntegerField and AbstractBigDecimalField.
| + | |
| − | | + | |
| − | == M5 (planned: Friday, February 07, 2014) ==
| + | |
| − | | + | |
| − | == M6 (planned: Friday, March 22) ==
| + | |
| − | | + | |
| − | == M7 (planned: Friday, May 10) ==
| + | |
| − | | + | |
| − | == RC1 (planned: Friday, May 24) ==
| + | |
| − | | + | |
| − | == RC2 (planned: Friday, May 31) ==
| + | |
| − | | + | |
| − | == RC3 (planned: Friday, June 07) ==
| + | |
| − | | + | |
| − | == RC4 (planned: Friday, June 14) ==
| + | |
| − | | + | |
| − | == Bugfixes and Change Request Overview ==
| + | |
| − | | + | |
| − | The following list shows all Bugzilla Tickets which have been fixed for this release. The list also contains all new enhancements.
| + | |
| − | | + | |
| − | *[https://bugs.eclipse.org/bugs/buglist.cgi?list_id=7472259&classification=Technology&query_format=advanced&target_milestone=3.10.0%20Luna&target_milestone=3.10.0%20M1&target_milestone=3.10.0%20M2&target_milestone=3.10.0%20M3&target_milestone=3.10.0%20M4&target_milestone=3.10.0%20M5&target_milestone=3.10.0%20M6&product=Scout Bugzilla List for 3.10.0]
| + | |
| − | | + | |
| − | == Migration Guidelines ==
| + | |
| − | | + | |
| − | Some features and bugfixes sometimes require a change of the API. If this has been the case for the new release then you'll find behind the link below a guideline how to migrate your scout application to the newest release.
| + | |
| − | | + | |
| − | {{ScoutLink|Migration|3.10| Migration Guidelines for 3.10}}
| + | |
