Creating Carbon Projects

This page describes how to create Carbon projects. It includes the following sections:

Java Library Project

With a Java Library Project, you can refer to a jar file or a project in your workspace and make it a bundle that will be available to bundle classpath during the runtime. To create a Java Library Project, open the WSO2 Developer Studio Dashboard and click Java Library Project from the Carbon category.

Give a name to the project and click Next.

There are two ways to create a Java Library Artifact.

From File System
From Workspace

With the File System option, you can point to a jar file of the file system which you may use when creating your SOA application.

With the second option, all the available projects are listed in the workspace and you can select the project for which you want to create a Java Library dependency.

You can add multiple jars and projects for a single Java Library Project. Once you add the needed jars and projects, click Next if you want to add a parent project's POM information to this project's POM, or just click Finish.

Now you will see a Library Project has been created in the workspace. You can create a bundle out of that project by exporting it into a deployable archive. To do that, right-click on the project and click Export Project as Deployable Archive.

You can do the same thing by grouping the created Library Project in to a Composite Application Project and make a Composite Application Archive (CAR) out of it.

Carbon UI Bundle Project

To create a Carbon UI Bundle Project, open the WSO2 Developer Studio Dashboard and click Carbon UI Bundle Project from the Carbon category.

You can create a Carbon UI Bundle Project in two different ways.

Create New Carbon UI Bundle
Import Carbon UI Bundle From Workspace

With the New Carbon UI Bundle option, you will create a new bundle project from scratch. In the wizard page, you will see an entry called Deploy Path with entries to enter other necessary information. Deploy Path is the path where you specify all your resources like jsp files, html files etc. Give the necessary information and then click Next if you want to add a parent project's POM information to this project's POM, or just click Finish.

Now you will see that the new Carbon UI Bundle Project has been created in the workspace.

You will see a folder structure created according to the Deploy Path you have specified.

With the Import Carbon UI Bundle From Workspace option, you can refer to already defined Carbon UI Bundle Components in the workspace. With WSO2 Developer Studio, you can create a Carbon UI Bundle Component as well. This will be a stand-alone Eclipse Plugin Project with customizations relevant to making it a Carbon UI Bundle. This option is available under File -> New -> Other -> Carbon -> Carbon UI Component.

This also includes the same data you entered when creating a Carbon UI Bundle Project. Give the necessary information and click Finish.

Now you will see a new project has been created in the workspace. These projects will be available when you select the Import Carbon UI Bundle From Workspace option when creating a Carbon UI Bundle Project.

You can add your jsps/js/html files under the folder structure created according to the Deploy Path you have specified.

As you did for all the other projects, you can export the created Carbon UI Bundle Project in to a deployable artifact by right-clicking on the project and clicking Export Project as Deployable Archive. A bundle is created which you can deploy in to any Carbon Server. At the same time, you can group it as a Composite Application Project and create the Composite Application Archive as well.