See information about the latest product version
Converting a project to an application or library
Two options are available to convert existing projects to applications or libraries. Use Convert Single Project to convert a project with no references. Use Analyse and Convert Multiple Projects to convert one or more projects and any referenced resources.
- Read the concept information about Applications and libraries and Message Broker projects.
- To convert projects from previous versions of WebSphere Message Broker, you must first import them. For instructions, see Importing resources from previous versions.
- See an example of how you can migrate resources from a previous version to WebSphere Message Broker at Example: Manual conversion of Version 7.0 resources to applications and libraries.
- See a demonstration of how to convert projects to applications or libraries at IBM Education Assistant module: Applications and Libraries conversion.
- You imported an existing project from a previous version of WebSphere Message Broker. You want to use that project as the basis for a new application. You can convert the project into an application, then add the rest of the resources that are required to complete your solution.
- You have an existing project that contains resources that you want to reuse in several solutions. You can convert the project into a library, add any other required resources, then refer to that library from the appropriate applications.
- You imported your resources from a previous version of WebSphere Message Broker, and your message flow projects were migrated to Message Broker projects. You can convert all or some of your projects (such as Message Broker projects, Java projects, and message set projects) automatically to applications and libraries.
If you are converting a project that has no references to other resources, a simple conversion to an application or library is sufficient (see Converting a single project to an application or library). To convert all imported projects, or a project that contains references to other resources, a conversion wizard is provided, which uses rules to decide how to convert your resources. The wizard also converts associated projects, such as Java projects and message set projects, that are referenced by the selected projects (see Converting one or more projects with the conversion wizard).
Converting a single project to an application or library
- You can convert only Message Broker projects, Java projects, message set projects, and PHP projects.
- You can select multiple projects to convert to applications or libraries, but you cannot convert more than one Message Broker project at a time. To convert multiple Message Broker projects, you must use the conversion wizard.
- You cannot convert a project that refers to a library.
- If a Message Broker project is referenced by another Message Broker project, you can convert it to a library only.
- When you select the Convert single project option, no precondition checks are made, such as checking for references to projects that do not exist. If your project might contain references to other resources, use the wizard to analyze all projects and resources. To complete precondition checks before you convert a project, select the option Analyse and Convert Multiple Projects.
- In the Broker Development view, right-click the project or projects that you want to convert, then click .
- Select either an application or a library.
- Click Finish.
Converting one or more projects with the conversion wizard
To convert projects to applications or libraries, including precondition checks, complete the following steps.
- Creating resources in an application
- Creating resources in a library
- Adding and removing library references
- Deploying resources
If you converted a Message Broker project that referred to a Java project, you can now convert the Java project to a library so that it can be used by other applications. In the Broker Development view, right-click the Java project and click Include project in a new library. A library is created for the Java project, and the reference between the application and Java project is rebuilt.
You can also convert an application to a library, or a library to an application, by following the instructions in Converting between applications and libraries.