LCDS2.6不再集成webtier方式的集成（动态访问mxml和jsp嵌入mxml的tag）。需要通过集成webtier.war来处理

下文是webtier.war的使用方法。

下载地址 http://flexorg.wip3.adobe.com/modules/latest/FlexModule_j2ee.zip

1. This readme.txt file describes the Flex 3 compiler module for J2EE application servers.
4. *******************************
5. *   Introduction              *
6. *******************************
8. The Flex compiler module for J2EE application servers is a Web Application aRchive (WAR) file that you can deploy 
9. to most J2EE application servers that support servlets. This lets you rapidly compile, 
10. test, and deploy an application: Instead of compiling your MXML file into a SWF file and 
11. then deploying it and its wrapper files on a web server, you can just refresh the MXML 
12. file in your browser.
14. The Flex compiler module for J2EE application servers also provides a JSP tag library 
15. that lets you write Flex applications in JSPs.
17. The Flex compiler module for J2EE application is not for production use. The Flex compiler 
18. module web application should not be made available on a public-facing web server.
21. *******************************
22. *   Requirements              *
23. *******************************
25. The Flex compiler module for J2EE application servers comes as a WAR file. You can deploy 
26. it to any of the following J2EE web application servers:
27.  * Adobe JRun 4 Updater 7
28.  * Apache Tomcat 6.0.x
29.  * IBM WebSphere 6.1.x € IBM 1.5
30.  * BEA WebLogic 10 € Sun 1.5
31.  * JBoss 4.2.x
33.  
34. *******************************
35. *   Installation              *
36. *******************************
38. To install the Flex compiler module for J2EE application servers, create an application root 
39. directory and extract the contents of the WAR file into that directory. Your application server
40. might have a facility for deploying WAR files that you should use. After you deploy the WAR file,
41. restart your application server.
43. For example, on Tomcat, create a new directory under the {tomcat_install_dir}/webapps directory 
44. and expand the WAR file into that new directory. Save your MXML and JSP files in that directory.
47. *******************************
48. *   Configuration             *
49. *******************************
51. The Flex compiler module for J2EE application servers uses the following configuration files:
53. WEB-INF/flex-config.xml 
54. Defines the default settings for the Flex compiler.
56. WEB-INF/flex-webtier-config.xml 
57. Defines settings specific to the web tier, such as logging, caching, and debugging.
59. WEB-INF/web.xml 
60. Defines the web component settings for the Flex web application, such as servlet definitions 
61. and mappings, and tag library definitions.
63. To use custom SWC files or ActionScript classes in your applications, add them to the 
64. WEB-INF/flex/user-classes directory. 
66. If you want to use data visualization components in your Flex applications, add the appropriate 
67. SWC files to the WEB-INF/flex/libs directory.
69. ****************************************************************
70. *   Integrating with LiveCycle Data Services ES 2.6 or BlazeDS *
71. ****************************************************************
73. LiveCycle Data Services ES 2.6 and BlazeDS do not include an integrated web tier compiler, but you can easily integrate the Flex compiler module for J2EE into a LiveCycle Data Services ES or BlazeDS web application.
75.    1. Unzip the webtier.war file to a directory called webtier.
76.    2. Copy all of the files in the webtier/WEB-INF/lib to to the corresponding WEB-INF/lib directory of your LiveCycle Data Service ES web application. Do not overwrite any existing files.
77.    3. Make a backup copy of the services-config.xml file WEB-INF/flex directory of your LiveCycle Data Service ES web application.
78.    3. With the exception of the services-config.xml file, copy all of the files and directories in the webtier/WEB-INF/flex directory to the corresponding WEB-INF/flex directory of your LiveCycle Data Service ES web application. Do not overwrite any existing files. In the event that you accidentally overwrite the services-config.xml file in your web application, restore it using the backup copy you created.
79.    4. Copy the player and locale directories as well as the datavisualization.swc file from the LiveCycle Data Services ES or BlazeDS install_root/resources/frameworks/libs directory to the WEB-INF/flex/libs directory of your LiveCycle Data Service ES web application.
80.    5. From the following web.xml sample content, add the text contained between
81.    <!-- start from webtier web.xml -->
82.    and
83.    <!-- end from webtier web.xml -->
84.    to the web.xml file in the WEB-INF directory of your LiveCycle Data Service ES or BlazeDS web application:
86. <?xml version="1.0" encoding="UTF-8"?>
87.  <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
89. <web-app>
90.    <display-name>LiveCycle Data Services Samples</display-name>
91.    <description>LiveCycle Data Services Application with Samples</description>
92.    
93.    <!-- start from webtier web.xml -->
94.  <context-param>
95.  <param-name>flex.class.path</param-name>
96.  <param-value>/WEB-INF/flex/hotfixes,/WEB-INF/flex/jars</param-value>
97.  </context-param>
98.  <!-- end from webtier web.xml --> 
100.  <!-- Http Flex Session attribute and binding listener support -->
101.    <listener>
102.    <listener-class>flex.messaging.HttpFlexSession</listener-class>
103.    </listener>
105.  <!-- MessageBroker Servlet -->
106.    <servlet>
107.    <servlet-name>MessageBrokerServlet</servlet-name>
108.    <display-name>MessageBrokerServlet</display-name>
109.    <servlet-class>flex.messaging.MessageBrokerServlet</servlet-class>
110.    <init-param>
111.    <param-name>services.configuration.file</param-name>
112.    <param-value>/WEB-INF/flex/services-config.xml</param-value>
113.    </init-param>
114.    <load-on-startup>1</load-on-startup>
115.    </servlet>
116.    
117.    <servlet>
118.    <servlet-name>PDFResourceServlet</servlet-name>
119.    <display-name>Helper for retrieving dynamically generated PDF documents.</display-name>
120.    <servlet-class>flex.samples.pdfgen.PDFResourceServlet</servlet-class>
121.    </servlet>
122.    
123.    <!-- start from webtier web.xml -->
124.  <servlet>
125.  <servlet-name>FlexMxmlServlet</servlet-name>
126.  <display-name>MXML Processor</display-name>
127.  <description>Servlet wrapper for the Mxml Compiler</description>
128.  <servlet-class>flex.bootstrap.BootstrapServlet</servlet-class>
129.  <init-param>
130.  <param-name>servlet.class</param-name>
131.  <param-value>flex.webtier.server.j2ee.MxmlServlet</param-value>
132.  </init-param>
133.  <init-param>
134.  <param-name>webtier.configuration.file</param-name>
135.  <param-value>/WEB-INF/flex/flex-webtier-config.xml</param-value>
136.  </init-param>
137.  <load-on-startup>1</load-on-startup>
138.  </servlet>
140.  <servlet>
141.  <servlet-name>FlexSwfServlet</servlet-name>
142.  <display-name>SWF Retriever</display-name>
143.  <servlet-class>flex.bootstrap.BootstrapServlet</servlet-class>
144.  <init-param>
145.  <param-name>servlet.class</param-name>
146.  <param-value>flex.webtier.server.j2ee.SwfServlet</param-value>
147.  </init-param>
148.  <!-- SwfServlet must be initialized after MxmlServlet -->
149.  <load-on-startup>2</load-on-startup>
150.  </servlet>
152.  <servlet>
153.  <servlet-name>FlexForbiddenServlet</servlet-name>
154.  <display-name>Prevents access to *.as/*.swc files</display-name>
155.  <servlet-class>flex.bootstrap.BootstrapServlet</servlet-class>
156.  <init-param>
157.  <param-name>servlet.class</param-name>
158.  <param-value>flex.webtier.server.j2ee.ForbiddenServlet</param-value>
159.  </init-param>
160.  </servlet>
162.  <servlet>
163.  <servlet-name>FlexInternalServlet</servlet-name>
164.  <servlet-class>flex.bootstrap.BootstrapServlet</servlet-class>
165.  <init-param>
166.  <param-name>servlet.class</param-name>
167.  <param-value>flex.webtier.server.j2ee.filemanager.FileManagerServlet</param-value>
168.  </init-param>
169.  <load-on-startup>10</load-on-startup>
170.  </servlet>
171.  <!-- end from webtier web.xml --> 
172.    
173.    <servlet-mapping>
174.    <servlet-name>MessageBrokerServlet</servlet-name>
175.    <url-pattern>/messagebroker/*</url-pattern>
176.    </servlet-mapping>
178.  <servlet-mapping>
179.    <servlet-name>PDFResourceServlet</servlet-name>
180.    <url-pattern>/dynamic-pdf/*</url-pattern>
181.    </servlet-mapping>
183. <!-- start from webtier web.xml --> 
185.  <servlet-mapping>
186.  <servlet-name>FlexMxmlServlet</servlet-name>
187.  <url-pattern>*.mxml</url-pattern>
188.  </servlet-mapping>
190.  <servlet-mapping>
191.  <servlet-name>FlexSwfServlet</servlet-name>
192.  <url-pattern>*.swf</url-pattern>
193.  </servlet-mapping>
195.  <servlet-mapping>
196.  <servlet-name>FlexForbiddenServlet</servlet-name>
197.  <url-pattern>*.as</url-pattern>
198.  </servlet-mapping>
200.  <servlet-mapping>
201.  <servlet-name>FlexForbiddenServlet</servlet-name>
202.  <url-pattern>*.swc</url-pattern>
203.  </servlet-mapping>
205.  <servlet-mapping>
206.  <servlet-name>FlexInternalServlet</servlet-name>
207.  <url-pattern>/flex-internal/*</url-pattern>
208.  </servlet-mapping>   
209.  <!-- end from webtier web.xml --> 
210. <welcome-file-list>
211.    <welcome-file>index.html</welcome-file>
212.    <welcome-file>index.htm</welcome-file>
213.    </welcome-file-list>
214. <!-- for WebSphere deployment, please uncomment -->
215.    <!--
216.    <resource-ref>
217.    <description>Flex Messaging WorkManager</description>
218.    <res-ref-name>wm/MessagingWorkManager</res-ref-name>
219.    <res-type>com.ibm.websphere.asynchbeans.WorkManager</res-type>
220.    <res-auth>Container</res-auth>
221.    <res-sharing-scope>Shareable</res-sharing-scope>
222.    </resource-ref>
223.    -->
225.  <!--
226.    <security-constraint>
227.    <web-resource-collection>
228.    <web-resource-name>Protected Sample</web-resource-name>
230.  <url-pattern>/messagebroker/amf/SampleSalaryRO</url-pattern>
231.    <http-method>GET</http-method>
232.    <http-method>POST</http-method>
233.    </web-resource-collection>
235.  <auth-constraint>
236.    <role-name>sampleusers</role-name>
237.    </auth-constraint>
238.    </security-constraint>
239.    -->
241.  <login-config>
242.    <auth-method>BASIC</auth-method>
243.    </login-config>
245.  <!--
246.    <security-role>
247.    <role-name>sampleusers</role-name>
248.    </security-role>
249.    -->
250.    
251.    <!-- start from webtier web.xml --> 
252.  <taglib>
253.  <taglib-uri>FlexTagLib</taglib-uri>
254.  <taglib-location>/WEB-INF/lib/flex-bootstrap-jsp.jar</taglib-location>
255.  </taglib>
256.  <!-- end from webtier web.xml -->
257. </web-app>
260. *******************************
261. *   About the JSP Tag Library *
262. *******************************
264. The Flex 3 Tag Library for JSP is a set of JSP tags that you use to embed Flex applications 
265. in a JSP page. You should use the Flex 3 Tag Library for JSP to do any of the following:
266.  * Include an MXML (Flex) application in an existing HTML/JSP page.
267.  * Include history management, player detection, or Express Install for one application but 
268.  not another application.
269.  * Present an MXML application if the correct version of the Adobe Flash Player is installed, 
270.  or an HTML version otherwise.
271.  * Present one of a few versions of the same basic application determined through logic in a 
272.  JSP page. 
274. The <mxml> tag compiles the MXML code, if required, and then generates the HTML fragment to 
275. load Adobe Flash Player and the resulting SWF file in your JSP page. You can do this in two 
276. ways. The source tag attribute lets you specify the source file to compile. This is useful 
277. because the JSP tag writes the HTML fragment for you. The other approach is to specify the 
278. source as the body content of the tag. Then, you use JSP scriptlets to generate the MXML source.
280. The <flashvar> tag lets you pass variables to a Flex application. You access these variables 
281. by using the Application.application.parameters object.
283. Although the Flex 3 Tag Library for JSP is similar to the tag library in earlier versions of 
284. Flex, there are some differences. The tag attributes of the <mxml> tag are simpler; full 
285. control of all the HTML wrapper attributes is no longer available. However, the tag library 
286. includes attributes that enable history management and Flash Player detection on a per-tag basis. 
287. The <param> and <flash> tags were eliminated to simplify tag usage. 
290. *******************************
291. *  Using the JSP Tag Library  *
292. *******************************
294. To use the Flex 3 Tag Library in a JSP page, add the following tag library declaration 
295. to your JSP page:
297. <%@ taglib uri="FlexTagLib" prefix="mm" %>
299. As with any JSP taglib directive, this line must appear before you use any tags in the 
300. Flex JSP tag library.
302. You can then use the <mxml> tag to insert a Flex application in the JSP page. You can 
303. either reference a separate MXML file to be included in the JSP page, or you can add the MXML 
304. syntax directly in the JSP page.
306. The following example shows the <mxml> tag with the source attribute to include an external 
307. MXML file:
309. <mm:mxml source="CustomerServiceChat.mxml"/>
311. Alternatively, you can use the <mxml> tag with inline MXML source code, as the following 
312. example shows:
314. <mm:mxml>
315.     <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" xmlns="*">
316.         <mx:Text label="Hello World">
317.     </mx:Application>
318. </mm:mxml>
320. Use the <mxml> tag carefully, as any JSP execution that results in different MXML source 
321. code causes recompilation. Each distinct instance of MXML source code is cached separately 
322. and checked for recompilation separately.
324. For example, the following JSP code results in two sets of MXML source code; one is 
325. created when request.isUserInRole("admin") is true, and another is created when 
326. request.isUserInRole("admin") is false:
328. <mm:mxml>
329.     <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" xmlns="*">
330.         <% if (request.isUserInRole("admin")) { %>
331.             <AdminConsole/>
332.         <% } else { %>
333.             <UserConsole/>
334.         <% } %>
335.     </mx:Application>
336. </mm:mxml>
338. Updating the <flashvar> tag does not cause a recompilation. 
340. You can mix JSP scriptlets with MXML to create a dynamic application. The following example 
341. uses <mxml> and <flashvar> tags with inline MXML code to get the Java version and current date:
343. <%@ taglib uri="FlexTagLib" prefix="mm" %>
344. <mm:mxml height="300" width="600" usePlayerDetection="true" useExpressInstall="false">
345.     <mm:flashvar name="javaVersion" value='<%= System.getProperty("java.version") %>'/>
346.     <mm:flashvar name="currentDate" value="<%= new java.util.Date().toString() %>"/>
347.     <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" width="400" height="300">
348.         <mx:VBox>
349.             <mx:HBox>
350.                 <mx:Label text="Java version: "/>
351.                 <mx:Label text="{Application.application.parameters.javaVersion}" fontWeight="bold"/>
352.             </mx:HBox>
353.             <mx:HBox>
354.                 <mx:Label text="Current Time: "/>
355.                 <mx:Label text="{Application.application.parameters.currentDate}" fontWeight="bold"/>
356.             </mx:HBox>
357.         </mx:VBox>
358.     </mx:Application>
359. </mm:mxml>
361. The following example shows how to invoke an external MXML file while passing dynamic 
362. flashvar variables to it:
364. <%@ taglib uri="FlexTagLib" prefix="mm" %>
365. <mm:mxml source="flashvarTest.mxml" width="400" height="200">
366.     <mm:flashvar name="javaVersion" value='<%= System.getProperty("java.version") %>'/>
367.     <mm:flashvar name="currentDate" value="<%= new java.util.Date().toString() %>"/>
368. </mm:mxml>
370. You can use the <mxml> tag attributes to enforce the use of a minimum Flash Player version. 
371. You can return one version of a Flex application when the required version of Flash Player 
372. is available, or an alternate version of the application when the required Player is unavailable. 
373. You can also use the <mxml> tag to set up Express Install so that clients that do not have 
374. the minimum required Player are prompted to install it.
376. You set the minimum required version in the <flash-player> in the flex-webtier-config.xml 
377. file.
379. The following example enables Flash Player Detection but disables Express Install. With this 
380. configuration, the server returns the alternateContentPage instead of proceeding to upgrade 
381. Flash Player through Express Install if the client does not have the minimum required Player 
382. version.
384. <mm:mxml 
385.     source="FlexApplication.mxml" 
386.     usePlayerDetection="true" 
387.     useExpressInstall="false" alternateContentPage="MyLegacyApplication.html"
388. />
391. *******************************
392. *   Tag Descriptions          *
393. *******************************
395. <mxml>    
396. Compiles the MXML code and generates the HTML wrapper. Includes MXML source as body content, 
397. or specify an external source file with the source attribute.  
399. The <mxml> tag has the following attributes:
400.  
401.  * source - Location of the MXML code to compile.
402.  
403.  * id  - Name used to expose the SWF file through the id or name attribute of the HTML object 
404.  or embed tag.
405.  
406.  * height - Height of the MXML wrapper.
407.  
408.  * width -  Width of the MXML wrapper.
409.  
410.  * useHistoryManagement - Include history management for the Flex application.
411.  
412.  * usePlayerDetection - Include Flash Player version detection for the Flex application. The 
413.  minimum required version is set in the flex-webtier-config.xml file.
414.  
415.  * useExpressInstall - Install Flash Player through Express Install; ignored if Flash Player 
416.  version detection is disabled.
417.  
418.  * alternateContentPage - Present this alternate page when the Flash Player version is unavailable; 
419.  ignored if Flash Player version detection is disabled.
422. <flashvar>    
423. Specifies a variable to pass to your Flex application.  
425. The <flashvar> tag has the following attributes:
426.  
427.  * name -   Specifies the name of the flashvar variable.
428.  
429.  * value -  Specifies the value of the flashvar variable.