User manual MACROMEDIA FLEX 2-MIGRATING APPLICATIONS TO FLEX 2

[. . . ] Migrating Applications to Flex 2 Adobe Flex 2 ® TM © 2006 Adobe Systems Incorporated. Migrating Applications to FlexTM 2 If this guide is distributed with software that includes an end-user agreement, this guide, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe Systems Incorporated. Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end-user license agreement. [. . . ] In addition to the changes here, the Flex data services architecture has changed. For more information, see Chapter 9, "Data Services, " on page 135. mx. servicetags. HTTPService The HTTPService class was moved to mx. rpc. http. HTTPService. The following table describes changes to the HTTPService class: Member protocol Change description Deprecated. For backward compatibility, the default value of the destination property is defaultHttps. Use the destination property. serviceName The HTTPService logic has been changed to match the WebService logic. Previously, HTTPServices raised a fault for an invalid resultFormat at send time; now, HTTPService throws an Error as soon as an invalid value is set. Service tags 95 mx. servicetags. RemoteObject The RemoteObject class was moved to mx. rpc. remoting. RemoteObject. The following table describes changes to the RemoteObject class: Member encoding endpoint Change description Removed. Channels defined in the flex-services. xml file replace the need for this property. Has been added again to allow clients to use this tag without the configuration file at compile time. Channels defined in the flex-services. xml file replace the need for this property. This is now controlled in the service definition in the flex-services. xml file. You set it with the <source> tag. named protocol source type All RemoteObject sources need destination entries in the flex-services. xml file. You should now name every service and not use the actual source class as the name. All definitions of named RemoteObjects must be moved into the flex-services. xml file. mx. servicetags. WebService The following table describes changes to the WebService class: Member protocol Change description Deprecated. For backward compatibility, the default value of the destination property is defaultHttps. Use the destination property. serviceName The WebService class has the following changes: The WebService class was moved to mx. rpc. soap. WebService. You must move the definitions of named services to the flex-services. xml file. The unnamed whitelist must be updated in the defaultHttp destination. 96 Flex Classes Callback URLs Callback URLs are no longer necessary in Flex 2. Use messaging channels with endpoint mappings instead. Skins This section describes changes to Flex classes in the mx. skins package. For more information, see "Using skinning" on page 124. mx. skins. halo. RectBorder This class is now named HaloBorder. mx. skins. halo. PopUpIcon The following table describes changes to the PopUpIcon class: Member arrowColor Change description This property is now private. mx. skins. ProgrammaticSkin The following table describes changes to the ProgrammaticSkin class: Member invalidateStyle() updateNow() Change description styleChanged() validateNow() mx. skins. RectBorder This class is now named mx. skins. RectangularBorder. Skins 97 States This section provides information about changes to classes in the mx. states package. mx. states. AddChild The following table describes changes to AddChild class: Member added instanceCreated target Change description This property is now internal. This property is now internal. relativeTo mx. states. SetEventHandler The following table describes changes to SetEventHandler class: Member event Change description name mx. states. SetProperty The following table describes changes to SetProperty class: Member property Change description name mx. states. SetStyle The following table describes changes to SetStyle class: Member property Change description name 98 Flex Classes Utilities This section provides information about changes to classes in the mx. utils package. mx. utils. XMLUtil The following table describes changes to XMLUtil class: Member createXML() Change description createXMLDocument() Validators This section provides information about changes to classes in the mx. validator package. mx. validator. Validator The following table describes the changes to the Validator class: Member DIGITS disable() disableStructure enable() enableStructure() field hasErrors() isStructureValid() isValid() LETTERS Change description DECIMAL_DIGITS enabled enabled enabled enabled source and property Removed. validate() validate() This property was private and is now protected; it is now named ROMAN_LETTERS. Removed. validateAll() validationError() Validators 99 100 Flex Classes CHAPTER 4 Data Providers This topic describes migrating data providers, including the dataProvider property of Flex controls and the ways you access and manipulate the data represented by the dataProvider property. [. . . ] In Flex 1. x, you could change the feedback indicator with the action property of the event. In Flex 2, use the showFeedback() method to control the value of this property for all DragManager-related events. To get this value on any DragEvent object, you now use the getFeedback() method. Setting actions You no longer set the action property of the event object. Instead, you must call the DragManager. setFeedback() method, as the following example shows. [. . . ]