|
|
| (68 intermediate revisions by 14 users not shown) |
| Line 1: |
Line 1: |
| − | {{ScoutPage|cat=Release 4.0}}
| + | 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 4.0]] release shipped with Eclipse [[Luna]].
| + | |
| − | | + | |
| − | == M1 (Friday, August 23, 2013) ==
| + | |
| − | | + | |
| − | === Scout is using GIT flow ===
| + | |
| − | {{Bug|411769}}
| + | |
| − | | + | |
| − | Scout is now using GIT flow with 4.0 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}}.
| + | |
| − | | + | |
| − | === 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
| + | |
| − | | + | |
| − | === Minor API Enhancements ===
| + | |
| − | With {{Bug|416848}} and {{Bug|416862}} we introduce some minor API changes to make ServiceTunnelServlet and Scheduler more extensible.
| + | |
| − | | + | |
| − | == M3 (Friday, November 15) ==
| + | |
| − | | + | |
| − | === Service Tunnel Plugin ===
| + | |
| − | | + | |
| − | [[Image:Scout_Servicetunnel_Class_Diagram.png|thumb|right|500px|Scout service tunnel classes.]]
| + | |
| − | | + | |
| − | With bug {{Bug|405353}}, we have introduced a new plugin: <tt>org.eclipse.scout.rt.servicetunnel</tt> to allow server-server communication in the same way as the existing client-server communication.
| + | |
| − | | + | |
| − | This new plugin contains now the classes handling the service tunnel (client-server {{ScoutLink|Concepts|Communication|communication}}) that were previously contained in the <tt>org.eclipse.scout.rt.client</tt> plugin. The service tunnel classes are now completly independent from the scout client and can therefore be reused for server-server communication.
| + | |
| − | | + | |
| − | As a result the client plugin has a new dependency on the new servicetunnel plugin. If you work with plugin based product file (every project created by the Scout SDK does) you will have to 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.
| + | |
| − | | + | |
| − | 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 (Friday, December 20) ==
| + | |
| − | | + | |
| − | === Removal of Legacy Functionality ===
| + | |
| − | | + | |
| − | * With {{Bug|421586}} Deprecated Code for 4.0 will be removed
| + | |
| − | * With {{Bug|422055}} The Legacy Text Fragment is removed
| + | |
| − | * With {{Bug|403310}} Scout Client Testing Framework will be removed (To be replaced with junit based integration tests)
| + | |
| − | * With {{Bug|422052}} Legacy SQL Support in Scout Client will be removed in the next release (Scout 3.11)
| + | |
| − | | + | |
| − | === 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 and Columns ===
| + | |
| − | With {{Bug|422120}}, {{Bug|422160}}, {{Bug|422163}}, {{Bug|423163}} issues with number fields and columns 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 for number fields and columns was consolidated.
| + | |
| − | | + | |
| − | Consider these changes for migration:
| + | |
| − | | + | |
| − | ''Consistent Rounding''
| + | |
| − | * There is a new property '''roundingMode''' for all number fields and columns 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 columns and ROUND_HALF_UP for decimal number fields and columns. (Before the rounding behavior for decimal fields and columns was ROUND_HALF_EVEN.)
| + | |
| − | | + | |
| − | ''Consistent API''
| + | |
| − | * IDecimalField now extends INumberField. The UI Interfaces ISwingScoutDecimalField, ISWTScoutDecimalField and IRwtScoutDecimalField together with their implementations were removed.
| + | |
| − | * IDecimalColumn now extends INumberColumn.
| + | |
| − | * AbstractDecimalField is now a Subclass of AbstractNumberField, hence all changes mentioned below for AbstractNumberField apply as well for AbstractDecimalField.
| + | |
| − | * AbstractDecimalColumn is now a Subclass of AbstractNumberColumn, hence all changes mentioned below for AbstractNumberColumn apply as well for AbstractDecimalColumn.
| + | |
| − | * INumberField.setFormat(DecimalFormat): parameter's type changed from String to DecimalFormat
| + | |
| − | * INumberField.getFormat(): return type changed from String to DecimalFormat
| + | |
| − | * AbstractNumberField.getConfiguredFormat() is deprecated, for setting the format override initConfig() and call setFormat(DecimalFormat)
| + | |
| − | * AbstractNumberField.createNumberFormat() is deprecated, use getFormat() 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.)
| + | |
| − | * INumberColumn.setNumberFormat(NumberFormat) is deprecated, use setFormat(DecimalFormat) instead
| + | |
| − | * INumberColumn.setFormat(DecimalFormat): parameter's type changed from String to DecimalFormat
| + | |
| − | * INumberColumn.getFormat(): return type changed from String to DecimalFormat
| + | |
| − | * AbstractNumberColumn.getConfiguredFormat() is deprecated, for setting the format override initConfig() and call setFormat(DecimalFormat)
| + | |
| − | | + | |
| − | ''Consistent semantics for format setters''
| + | |
| − | * New: Number fields and columns hold an internal DecimalFormat instance. All convenience setters and getters for DecimalFormat's properties (e.g. setGroupingUsed(boolean), isGroupingUsed() delegate to the internal instance. (Old behavior for the columns was: If a format was set, this would have priority over the convenience properties.)
| + | |
| − | | + | |
| − | ''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.
| + | |
| − | | + | |
| − | === Diagnostic Servlet ===
| + | |
| − | With {{Bug|423598}} Eclipse Scout has now a diagnostic servlet. This creates an html page with diagnostic information like JVM Memory allocation and cpu architecture. Its also possible to add diagnostic information from any class entity. If an Entity want to provide diagnostic status info it has to implement org.eclipse.scout.rt.server.admin.diagnostic.IDiagnostic and has to register itself at the DiagnosticFactory:
| + | |
| − | | + | |
| − | org.eclipse.scout.rt.server.admin.diagnostic.DiagnosticFactory.addDiagnosticStatusProvider()
| + | |
| − | org.eclipse.scout.rt.server.admin.diagnostic.DiagnosticFactory.removeDiagnosticStatusProvider()
| + | |
| − | | + | |
| − | Here a preview how it looks like:
| + | |
| − | [[File:Eclipse_Scout-LunaM4-Diagnostics.png]]
| + | |
| − | | + | |
| − | == M5 (Friday, January 31, 2014) ==
| + | |
| − | | + | |
| − | === SDK: Support for more Property Types ===
| + | |
| − | {{Bug|422163}}
| + | |
| − | | + | |
| − | The [[Scout/SDK/Object_Properties_View | Object Property View]] provides support for more property types that exist in the Scout Runtime:
| + | |
| − | * Drag & Drop Types
| + | |
| − | * Composer Attribute Types
| + | |
| − | * Rounding Mode for NumberFields
| + | |
| − | * Min- & Max-Values for BigDecimal- and BigInteger-Fields
| + | |
| − | | + | |
| − | === SDK: Product Launchers improved ===
| + | |
| − | {{Bug|414535}}
| + | |
| − | | + | |
| − | The Scout SDK now finds all .product files in the workspace which gives you more flexibility on how to organize your projects. You can therefore configure each product file as a product launcher. Furthermore links to the web pages are provided for RAP and Server products (when the products are running).
| + | |
| − | | + | |
| − | [[Image:ScoutProductLauncherNews.png|400px]]
| + | |
| − | | + | |
| − | | + | |
| − | === SDK: Create Elements without Scout Explorer ===
| + | |
| − | | + | |
| − | For some Elements it is no longer required to switch to the Scout Explorer and then drill down to the correct nodes. You can create them directly by using a key stroke:
| + | |
| − | * By typing Ctrl+Space within a [[Scout/Concepts/CodeType | CodeType]] you can directly create a new nested [[Scout/Concepts/Code | Code]].
| + | |
| − | * By typing Ctrl+Space in an NLS context you can create new translations.
| + | |
| − | * Typing Ctrl+N and then searching for "Scout" provides access to the wizard for creating [[Scout/Concepts/CodeType | CodeTypes]], [[Scout/Concepts/LookupCall | LookupCalls]], [[Scout/Concepts/Page | Pages]], [[Scout/Concepts/Form | Forms]], [[Scout/Concepts/SearchForm | SearchForms]] and Services.
| + | |
| − | | + | |
| − | [[Image:ScoutNlsNewEntry.png|400px]] [[Image:ScoutNewWizards.png|400px]]
| + | |
| − | | + | |
| − | === SDK: Choose ServerSessions for Services ===
| + | |
| − | {{Bug|421985}}
| + | |
| − | | + | |
| − | When creating Services it is possible to choose which ServerSession that should be used in the registration of the service.
| + | |
| − | | + | |
| − | [[Image:ScoutChooseServerSession.png|400px]]
| + | |
| − | | + | |
| − | === SDK: Support for @ClassId Annotation ===
| + | |
| − | {{Bug|422960}}
| + | |
| − | | + | |
| − | For classes that implement the new ITypeWithClassId interface a @ClassId annotation can be added. This can be done for a specific class only by using the Quick Assist (Ctrl+1) or for an entire bundle by using the corresponding context menu on a Client-, Shared- or Server node in the Scout Explorer.
| + | |
| − | | + | |
| − | There also exists an option (Window->Preferences->Scout) to automatically create this annotation when an element is created with the Scout SDK.
| + | |
| − | | + | |
| − | == M6 (planned: Friday, March 14) ==
| + | |
| − | | + | |
| − | == M7 (planned: Friday, May 09) ==
| + | |
| − | | + | |
| − | == RC1 (planned: Friday, May 23) ==
| + | |
| − | | + | |
| − | == RC2 (planned: Friday, May 30) ==
| + | |
| − | | + | |
| − | == RC3 (planned: Friday, June 06) ==
| + | |
| − | | + | |
| − | == RC4 (planned: Friday, June 13) ==
| + | |
| − | | + | |
| − | == 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}}
| + | |
