Opening the Samples Source Code in Flex Builder 3

Unziping the samples source code

  1. Locate flex-src.zip in the WEB-INF\flex-src directory of the samples web application. For example, on a typical Windows installation using the Tomcat integrated server, flex-src.zip is located in C:\blazeds\tomcat\webapps\samples\WEB-INF\flex-src.
  2. Unzip flex-src.zip to the root folder of your Flex Builder workspace.

Creating Flex Builder projects

Create a Flex Builder project for each sample application you are interested in. There are several approaches to create a Flex Builder project for a Flex application that works with BlazeDS. We describe a simple approach here:

  1. Select File>New>Project… in the Flex Builder menu.
  2. Expand Flex Builder, select Flex Project and click Next.
  3. Provide a project name. Use the exact name of the sample folder. For example testdrive-httpservice.
  4. If you unzipped flex-src.zip in the root folder of your Flex Builder workspace, keep the use default location checkbox checked.
  5. Select Web Application as the application type.
  6. Select Java as the application server type.
  7. Check use remote object access service.
  8. Uncheck Create combined Java/Flex project using WTP. Note this checkbox will only exist if the Eclipse WTP feature is installed.
  9. Click Next.
  10. Make sure the root folder for LiveCycle Data Services matches the root folder of your BlazeDS web application. If you are using the Tomcat integrated server on Windows, the settings should look similar to this (you may need to adjust the exact folder based on your own settings):

    11. Root Folder: C:\blazeds\tomcat\webapps\samples
    Root URL: http://localhost:8400/samples/
    Context Root: /samples

  11. Click Validate Configuration, then Finish.

Adding a linked resource to the server configuration files

While working on the client-side of your applications, you may need to look at or change the BlazeDS server-side configuration. For example, you may need to look at existing destinations or create a new one. You can create a linked resource inside a Flex Builder project to make the BlazeDS configuration files easily accessible.

To create a linked resource to the BlazeDS configuration files:

  1. Right-click the project name in the project navigation view.
  2. Select New>Folder in the popup menu.
  3. Specify the name of the folder as it will appear in the navigation view. This name can be different from the name of the folder in the file system. For example type server-config.
  4. Click the Advanced button.
  5. Check Link to folder in the file system.
  6. Click the Browse button and select the flex folder under the WEB-INF directory of your web application. For example, on a typical Windows installation using the Tomcat integrated server, select C:\blazeds\tomcat\webapps\samples\WEB-INF\flex.
  7. Click Finish. The BlazeDS configuration files are now available in your Flex Builder project under the server-config folder.