From jbosstools-commits at lists.jboss.org Thu Mar 18 13:19:38 2010 Content-Type: multipart/mixed; boundary="===============2572998541147227783==" MIME-Version: 1.0 From: jbosstools-commits at lists.jboss.org To: jbosstools-commits at lists.jboss.org Subject: [jbosstools-commits] JBoss Tools SVN: r20907 - trunk/esb/docs/esb_ref_guide/en-US. Date: Thu, 18 Mar 2010 13:19:38 -0400 Message-ID: <201003181719.o2IHJc0j025263@svn01.web.mwc.hst.phx2.redhat.com> --===============2572998541147227783== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: smukhina Date: 2010-03-18 13:19:35 -0400 (Thu, 18 Mar 2010) New Revision: 20907 Modified: trunk/esb/docs/esb_ref_guide/en-US/esb_editor.xml trunk/esb/docs/esb_ref_guide/en-US/esb_support.xml Log: https://jira.jboss.org/jira/browse/JBDS-1164 Documentation issues in ESB Tools Reference Guide - fixed Modified: trunk/esb/docs/esb_ref_guide/en-US/esb_editor.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/esb/docs/esb_ref_guide/en-US/esb_editor.xml 2010-03-18 15:59:15 U= TC (rev 20906) +++ trunk/esb/docs/esb_ref_guide/en-US/esb_editor.xml 2010-03-18 17:19:35 U= TC (rev 20907) @@ -12,7 +12,7 @@ ESB Editor = ESB editor has lots of useful features, they are described in d= etails in this chapter. In - addition you'll get to know with how ESB Editor uses combined + addition you'll get to know how ESB Editor uses combined visual and source editing of esb files. =
@@ -195,7 +195,7 @@ = - As you can see on the bath figures above, the context menu w= ill also prompt you to + As you can see on the both figures above, the context menu w= ill also prompt you to insert one of the Actions that are supplied out-of-the-box wit= h JBoss ESB. After choosing one an appeared N= ew Pre-Packed Action wizard will ask you to fill out a name field and other fields specifi= c for each Action Modified: trunk/esb/docs/esb_ref_guide/en-US/esb_support.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/esb/docs/esb_ref_guide/en-US/esb_support.xml 2010-03-18 15:59:15 = UTC (rev 20906) +++ trunk/esb/docs/esb_ref_guide/en-US/esb_support.xml 2010-03-18 17:19:35 = UTC (rev 20907) @@ -1,535 +1,535 @@ - - - - - - JBoss Developer Studio - Eclipse - ESB - Java - JBoss - - - - ESB Support - - In this section we will focus on all concepts that JBoss Tools - integrate for working with JBoss ESB. - -
- ESB Tools Installation - - This chapter will provide you with the information o= n how to install - JBoss ESB plugin into Eclipse. - - ESB Tools come as one module of JBoss Tools project.= Since ESB Tools have a - dependence on other JBoss Tools modules we recomme= nd you to install a bundle - of all JBoss - Tools plug-ins. You can find all = necessary installation instructions on JBoss Wiki in the InstallingJBossTools section. -
- -
- Creating a ESB Project - In this chapter we suggest a step-by-step walk-throu= gh of creating a new - ESB project. Let's try to create a new JBoss = ESB project. - - We will show you how to use the ESB Project Creation= wizard for creating a new ESB project and setting basic ESB classpath. - - Select - File >New > Project... - in the main menu bar or context menu f= or selected project and - then - ESB > ESB Project - in the dialog opened: - -
- Select a Wizard dialog - - - - - -
- - Clicking - Next - brings you to the JBoss ESB Project wi= zard page where a project name, ESB version and target JBoss Runtime are to= be specified. Specify, for example, - helloworld - as a Project name and accept the defau= lt ESB version. -
- JBoss ESB Project wizard - - - - - -
- By clicking Modify button you can op= en Project Facets Wizard page,where you can select = - facets that should be enabled for this project. - On the Project Facets Wizard page = you can also configure runtime for the application -
- Project Facets Wizard - - - - - -
- Next step provides you an opportunity to configure your p= roject for building a java application - = - Clicking - Next on this form - brings you to the ESB facet installati= on page where you can = - specify Java Source Directory and ESB Content Dire= ctory. ESB Content Directory is a folder that contains the most of - artifacts that an ESB archive needs. You also can= configure ESB libraries to the project by selecting a ESB runtime using on= e of the options: - - 1. Use - Server Supplied ESB Runtime - = - = - - 2. Select a ESB runtime from the JBoss ESB runtime list = predefined in the preferences. If you choose the first option, make sure th= at the project has the Target JBoss Runtime set and this runtime has a ESB = runtime installed. = - = - 3. Choose ESB Config Vertion. From the version 3.1.0 JBos= s ESB Tools supports three different jboss-esb.xsd versions: jbossesb-1.0.1= .xsd, jbossesb-1.1.0.xsd and jbossesb-1.2.0.xsd. = - Note: - If you use ESB 4.7 you should select jbossesb-1.2= .0.xsd. = -
- Install ESB facet step - - - - - -
- Click - Finish - and a ESB project with the default jboss-esb.xml = - will be created. - -
- The generated ESB project structure - - - - - -
- = -
- = -
- Creating ESB Project using JBoss Tools Project Exam= ples Wizard - JBoss Tools provides a Project Example wizard that i= s an easy way for users to create some kinds of projects to be used as exam= ples with some predefined structure. Let's start = - creating a ESB project using this wizard. - = - Before creating a ESB project example create JBoss R= untime with name - JBoss 4.2 Runtime, it will be used b= y your ESB project example. - - Select - File >New > Others - , in the main menu bar or context menu= for selected project and - then - JBoss Tools > Project Example= s - in the New dialog: - -
- Select a wizard - Project Examples - - - - - -
- - Clicking - Next - brings you to the wizard page where yo= u can select a ESB project example from the example list. - Every ESB example has two projects, one is a ESB p= roject and another is a Java project used to test the ESB project. - Here is a list of ready examples available: - = - - = - JBoss ESB = HelloWorld Example - demonstrates the minimal files necessary to= make a basic ESB component execute as well as to prove that the ESB os pro= perly configured. - JBoss ESB = HelloWorld Action Example - demonstrates the use of multiple act= ion invocations from a single configuration. You can use a single Action cl= ass and make multiple method calls or use multiple Action classes. <= /listitem> - JBoss ESB = HelloWorld File Action Example - demonstrates using the File gat= eway feature of the JBoss ESB. Files that are found in a particular directo= ry with a particular extension are sent to a JMS queue with actions for pro= cessing. - JBoss ESB = Web Service consumer1 Example - demonstrates how to consume a 18= 1 Web Service in an ESB action. - JBoss ESB = Web Service producer Example - demonstrates how to deploy a JSR1= 81 Webservice endpoint on JBossESB using the SOAPProcessor action. - JBoss ESB = Smooks CSV -> XML Example - demonstrates how to transform a c= omma separated value (CSV) file to an XML. - JBoss ESB = Smooks XML -> POJO Example - demonstrates the use of Smooks p= erforming a simple transformation by converting an XML file into Java POJOs= . - JBoss ESB = Smooks XML -> XML date-manipulation Example - demonstrates ho= w to manually define and apply a Message Transformation within JBoss ESB. = - JBoss ESB = Smooks XML -> XML Example - a very basic example of how to ma= nually define and apply a Message Transformation within JBoss ESB. It appli= es a very simple XSLT to a SampleOrder.xml message and prints the before an= d after XML to the console. - = - - = - = - - We will take as our example JBoss ESB HelloW= orld Example ESB and Client project: - = - = -
- JBoss Tools ESB Project Examples - - - - - -
- = - = - Choose them using the Ctrl button and then click = - Finish. As a result you will= get two projects created: -
- JBoss ESB Project Examples: helloworld and = helloworld_testclient - - - - - -
- = - Deploy the HelloWorld ESB project and run a test cl= ass in the client Java project to see the test result in the Console view.<= /para> -
- -
- Deploying a ESB Project - In this chapter you will see how to deploy a ESB pro= ject using the WTP deployment framework. - - Before deploying the project, open the Servers view = by selecting Window > Show View > Other > = - Server > Servers, = - create a JBoss Server in the Servers view and start it, an= d then right click the created JBoss server, = - select Add and Remove Pro= jects, = - and add the ESB projects you want to deploy from the left = side to the right side in the opened dialog. - -
- Add and Remove Projects - - - - - -
- = - Click Finish to add the project to the server. = - You also can drag the ESB project from the Project View to= the server. - = -
- Servers view - - - - - -
- = - Thus, you have just added the ESB project to the JBoss se= rver module list. Right click the JBoss Server and select Publish to publish the project on the server. - You can check the deploying result in the Console view. = - The Run and Debug options work on ESB projects c= ausing a (re)deploy for a user designated server. - You can also use the "Finger touch" for a quick restart o= f the project without restarting the server: -
- Finger Touch button - - - - - -
= - The "Finger" touches descriptors dependent on project (i.= e. web.xml for WAR, application.xml for EAR) and now it is also available f= or jboss-esb.xml in ESB projects. - You can also deploy your ESB project as an .esb arch= ive. Right-click on the project, choose Export: - = -
- Export of ESB project - - - - - -
= - = - Choose ESB > ESB File and click Ne= xt: = - = -
Choosing ESB File - - - - - -
= - = - And finally export the ESB project to the file system: choose the = destination, choose the target runtime if need a specific one and make the = appropriate settings for the archive. Then click Finish= . - = -
ESB Export - - - - - -
= - = - Your project is deployed as an .esb archive. - An ESB archive can be created for ESB projects only. It i= s also possible to deploy an .esb archive to a JBoss AS based server with J= Boss ESB installed. = - = - = -
- = -
- Creating a ESB File - In this chapter we suggest a step-by-step walk-throu= gh of creating your own - simple file. Let's try to organize a new ESB = file. - - We will show you how to use the Creation wizard for = creating a new ESB file. - - At first you should open any project. Select - File >New > Other... - in the main menu bar or context menu f= or selected project and - then - ESB > ESB File - in the New dialog: - -
- Select a wizard - ESB File - - - - - -
- - Clicking - Next - brings you to the wizard page where a = folder, a name and a version for the file should be specified. Choose, for = example, - jboss-esb.xml - as the name and accept the selected pr= ojects folder and the default - version. - = - Note: - From the version 3.1.0 JBoss ESB Tools suppor= ts three different jboss-esb.xsd versions: jbossesb-1.0.1.xsd, jbossesb-1.1= .0.xsd and jbossesb-1.2.0.xsd. - If you use ESB 4.7 you should select jbossesb= -1.2.0.xsd. - - -
- Folder, Name and Version for ESB file</titl= e> - <mediaobject> - <imageobject> - <imagedata fileref=3D"images/esb_s= upport/02_create_esb.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Thus, your file will be created in the selected proj= ects folder by default. If - you want to change the folder for your future file= click <emphasis> - <property>Browse...</property> - </emphasis> button to set needed folder or simply = type it.</para> - - <para>Clicking on <emphasis> - <property>Finish</property> - </emphasis> results in the file being generated. T= he wizard creates one xml - file.</para> - - </section> - <section id=3D"creating_esb_action"> - <title>Creating a ESB Action - From this chapter you will find out how to create a= ESB Action Java File. - At first you need to open a ESB= or simple Java project. Then you should select File > New>Other in the main menu or fr= om the context project menu. Then click ESB > ESB Acti= on in the New dialog. -
- Select a wizard - ESB Action - - - - - = - -
- After that click Next= and you will be brought to the New ESB Acti= on wizard. In this wizard the class name should be sp= ecified, also you can set a package or add a interface as for any Java clas= s. -
- New ESB Action wizard - - - - - = - -
- As a result, the ESB Action Java File will be created in the selected package and it will have o= rg.jboss.soa.esb.actions.AbstractActionPipelineProcessor as supe= rclass. - Clicking on Finish will generate the ESB Action class. Also this= class will become available in ESB Editor wizards. -
- = -
- Configuring ESB Runtime in Preferences - In this chapter you will know how to predefine a JBo= ss ESB runtime on the Preferences page. - - You may already know, there are two ways to set JBos= s ESB runtime when creating a ESB project, - one is to use the project target JBoss runtime, and anothe= r is to select a JBoss ESB runtime predefined in JBoss Tools preferences. - Let's configure it. - - Select - Window >Preferences > JBos= s Tools > JBoss ESB Runtime - , to open the JBoss ESB Runtime Prefere= nces page where you can add, remove and Edit a JBoss ESB runtime. - -
- JBoss ESB Runtimes - - - - - -
- - Select Add to open a dialog where you can specify the JBoss ESB runtime location, n= ame and version number. It's also possible to define configuration if you p= oint the home location to a Jboss AS or SOA-p, in case you select a standal= one ESB runtime location, the configuration combo will be empty and should = be ignored. = - You can also customize the libraries of the runti= me by checking the Customize JBoss ESB Runtime jars checkbox. - = -
- Configure new JBoss ESB Runtime - - - - - -
- - The new JBoss ESB Runtime will be configured. Click <= property>OK to finish and save the preferences. - You can use the configuration when creating a JBoss ESB project. - When a ESB runtime is configured for your ESB proje= ct you are able to change it to any other using the classpath container pag= e for ESB runtime. To do that, turn to the Package Explorer view and right-= click the "JBoss ESB Runtime" library. Select Propertie= s and a table listing all available JBoss ESB runtime= s will appear: - = -
- Classpath Container Page to change ESB run= time - - - - - -
- = - = - = - Choose one of them to set to the ESB project and cl= ick Ok. - ESB container allows Source and JavaDoc locations t= o be set via the Properties dialog on each contained .jar: right-click on a= ny .jar file, select Properties. = Choose Java Source Attachment and= select location (folder, JAR or zip) containing new source for the chosen = .jar using one of the suggested options (workspace, external folder or file= ) or enter the path manually: - = -
- Classpath Container: Java Source Attachmen= t - - - - - -
- Click on Apply an= d then on Ok. - To change Javadoc Location choose Javad= oc Location and specify URL to the documentation gene= rated by Javadoc. The Javadoc location will contain a file called package-list: - = -
- Classpath Container: Javadoc Location</tit= le> - <mediaobject> - <imageobject> - <imagedata fileref=3D"images/esb_= project/22_Javadoc.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Click on <emphasis><property>Apply</property></emph= asis> and then on <emphasis><property>Ok</property></emphasis>.</para> - = - </section> - - - <section id=3D"using_SOA"> = - <title>Using and Configuring SOA Platform - = - In this chapter you will know what is JBoss Enterpri= se SOA Platform and how you can configure it to use for your ESB projects.= - = - JBoss Enterprise SOA Platform delivers a flexible, s= tandards-based platform to integrate applications, SOA services, business e= vents and automate business processes. The SOA Platform integrates specific= versions of JBoss ESB, jBPM, Drools and the JBoss Enterprise Application P= latform that are certified to work together in a single supported enterpris= e distribution. - Having configured JBoss Enterprise SOA Platform for = your ESB project you don't need to install and configure ESB server and run= time as they are already included. - - Check here to find more details on the platform: JBoss Enterprise SO= A Platform and JBoss Enterprise SOA Platform Component Details.<= /para> - You can find out what is SOA here: Basics of SOA a= nd SO= A and EOA. - = - To configure the JBoss Enterprise SOA platform selec= t - Window > Preferences > Server >= ; Runtime Environments, that will open the Server Run= time Environments Preferences page where you can add, remove and edit a Ser= ver Runtime Environment. - = -
- Configure new Server Runtime Environment</t= itle> - <mediaobject> - <imageobject> - <imagedata fileref=3D"images/esb_p= roject/13NewServerRuntimeEnv.png"/> - </imageobject> - </mediaobject> - </figure> - = - <para>Select <emphasis><property>Add</property></emphasis>= , choose <emphasis><property>JBoss 4.2 Runtime</property></emphasis> as a t= ype of runtime environment, check the <emphasis><property>Create a new loca= l server</property></emphasis> checkbox and click <emphasis><property>Next<= /property></emphasis>:</para> = - <figure> - <title>Type of Server Runtime Environment - - - - - -
- = - On the next step you can specify a name of the serve= r runtime environment and browse to its location. Click Finish to add the server runtime environment. - = - = -
- New Server Runtime Environment Details</tit= le> - <mediaobject> - <imageobject> - <imagedata fileref=3D"images/esb_p= roject/15AddNew.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Now you have your SOA platform configured. To check = the configuration create a ESB Project using instructions described <xref l= inkend=3D"ESB_project_wizard"/>. As a result you will have two projects cre= ated:</para> - = - <figure> - <title>Helloworld Projects Created - - - - - -
- Then you will need to add JBoss ESB libraries to you= r projects to configure the SOA server runtime exactly for your projects. R= ight-click on your project, select Build Path > Add = Libraries: - = -
- Add Libraries - - - - - -
- = - Choose JBoss ESB Libraries and click Next: - = -
- ESB Libraries - - - - - -
- = - Select the necessary runtime to add to the project c= lasspath: - = - = -
- Select a ESB runtime - - - - - -
- Click Finish. - Now you can deploy your Helloworld project to the s= erver and run a test class in the client Java project to see the test resul= t in the Console view. - = - = - = -
- = - = - = - = - = - = - = - = - = - = - + + + + + + JBoss Developer Studio + Eclipse + ESB + Java + JBoss + + + + ESB Support + + In this section we will focus on all concepts that JBoss Tools + integrate for working with JBoss ESB. + +
+ ESB Tools Installation + + This chapter will provide you with the information o= n how to install + JBoss ESB plugin into Eclipse. + + ESB Tools come as one module of JBoss Tools project.= Since ESB Tools have a + dependence on other JBoss Tools modules we recomme= nd you to install a bundle + of all JBoss + Tools plug-ins. You can find all = necessary installation instructions on JBoss Wiki in the InstallingJBossTools section. +
+ +
+ Creating a ESB Project + In this chapter we suggest a step-by-step walk-throu= gh of creating a new + ESB project. Let's try to create a new JBoss = ESB project. + + We will show you how to use the ESB Project Creation= wizard for creating a new ESB project and setting basic ESB classpath. + + Select + File >New > Project... + in the main menu bar or context menu f= or selected project and + then + ESB > ESB Project + in the dialog opened: + +
+ Select a Wizard dialog + + + + + +
+ + Clicking + Next + brings you to the JBoss ESB Project wi= zard page where a project name, ESB version and target JBoss Runtime are to= be specified. Specify, for example, + helloworld + as a Project name and accept the defau= lt ESB version. +
+ JBoss ESB Project wizard + + + + + +
+ By clicking Modify button you can op= en Project Facets Wizard page,where you can select = + facets that should be enabled for this project. + On the Project Facets Wizard page = you can also configure runtime for the application +
+ Project Facets Wizard + + + + + +
+ Next step provides you an opportunity to configure your p= roject for building a java application + = + Clicking + Next on this form + brings you to the ESB facet installati= on page where you can = + specify Java Source Directory and ESB Content Dire= ctory. ESB Content Directory is a folder that contains the most of + artifacts that an ESB archive needs. You also can= configure ESB libraries to the project by selecting a ESB runtime using on= e of the options: + + 1. Use + Server Supplied ESB Runtime + = + = + + 2. Select a ESB runtime from the JBoss ESB runtime list = predefined in the preferences. If you choose the first option, make sure th= at the project has the Target JBoss Runtime set and this runtime has a ESB = runtime installed. = + = + 3. Choose ESB Config Vertion. From the version 3.1.0 JBos= s ESB Tools supports three different jboss-esb.xsd versions: jbossesb-1.0.1= .xsd, jbossesb-1.1.0.xsd and jbossesb-1.2.0.xsd. = + Note: + If you use ESB 4.7 you should select jbossesb-1.2= .0.xsd. = +
+ Install ESB facet step + + + + + +
+ Click + Finish + and a ESB project with the default jboss-esb.xml = + will be created. + +
+ The generated ESB project structure + + + + + +
+ = +
+ = +
+ Creating ESB Project using JBoss Tools Project Exam= ples Wizard + JBoss Tools provides a Project Example wizard that i= s an easy way for users to create some kinds of projects to be used as exam= ples with some predefined structure. Let's start = + creating a ESB project using this wizard. + = + Before creating a ESB project example create JBoss R= untime with name + JBoss 4.2 Runtime, it will be used b= y your ESB project example. + + Select + File >New > Others + , in the main menu bar or context menu= for selected project and + then + JBoss Tools > Project Example= s + in the New dialog: + +
+ Select a wizard - Project Examples + + + + + +
+ + Clicking + Next + brings you to the wizard page where yo= u can select a ESB project example from the example list. + Every ESB example has two projects, one is a ESB p= roject and another is a Java project used to test the ESB project. + Here is a list of ready examples available: + = + + = + JBoss ESB = HelloWorld Example - demonstrates the minimal files necessary to= make a basic ESB component execute as well as to prove that the ESB is pro= perly configured. + JBoss ESB = HelloWorld Action Example - demonstrates the use of multiple act= ion invocations from a single configuration. You can use a single Action cl= ass and make multiple method calls or use multiple Action classes. <= /listitem> + JBoss ESB = HelloWorld File Action Example - demonstrates using the File gat= eway feature of the JBoss ESB. Files that are found in a particular directo= ry with a particular extension are sent to a JMS queue with actions for pro= cessing. + JBoss ESB = Web Service consumer1 Example - demonstrates how to consume a 18= 1 Web Service in an ESB action. + JBoss ESB = Web Service producer Example - demonstrates how to deploy a JSR1= 81 Webservice endpoint on JBossESB using the SOAPProcessor action. + JBoss ESB = Smooks CSV -> XML Example - demonstrates how to transform a c= omma separated value (CSV) file to an XML. + JBoss ESB = Smooks XML -> POJO Example - demonstrates the use of Smooks p= erforming a simple transformation by converting an XML file into Java POJOs= . + JBoss ESB = Smooks XML -> XML date-manipulation Example - demonstrates ho= w to manually define and apply a Message Transformation within JBoss ESB. = + JBoss ESB = Smooks XML -> XML Example - a very basic example of how to ma= nually define and apply a Message Transformation within JBoss ESB. It appli= es a very simple XSLT to a SampleOrder.xml message and prints the before an= d after XML to the console. + = + + = + = + + We will take as our example JBoss ESB HelloW= orld Example ESB and Client project: + = + = +
+ JBoss Tools ESB Project Examples + + + + + +
+ = + = + Choose them using the Ctrl button and then click = + Finish. As a result you will= get two projects created: +
+ JBoss ESB Project Examples: helloworld and = helloworld_testclient + + + + + +
+ = + Deploy the HelloWorld ESB project and run a test cl= ass in the client Java project to see the test result in the Console view.<= /para> +
+ +
+ Deploying a ESB Project + In this chapter you will see how to deploy a ESB pro= ject using the WTP deployment framework. + + Before deploying the project, open the JBoss Server = View by selecting Window > Show View > Other > = + Server > JBoss Server View, = + create a JBoss Server in the Server view and start it, and= then right click the created JBoss server, = + select Add and Remove Pro= jects, = + and add the ESB projects you want to deploy from the left = side to the right side in the opened dialog. + +
+ Add and Remove Projects + + + + + +
+ = + Click Finish to add the project to the server. = + You also can drag the ESB project from the Project View to= the server. + = +
+ JBoss Server View + + + + + +
+ = + Thus, you have just added the ESB project to the JBoss se= rver module list. Right click the JBoss Server and select Publish to publish the project on the server. + You can check the deploying result in the Console view. = + The Run and Debug options work on ESB projects c= ausing a (re)deploy for a user designated server. + You can also use the "Finger touch" for a quick restart o= f the project without restarting the server: +
+ Finger Touch button + + + + + +
= + The "Finger" touches descriptors dependent on project (i.= e. web.xml for WAR, application.xml for EAR) and now it is also available f= or jboss-esb.xml in ESB projects. + You can also deploy your ESB project as an .esb arch= ive. Right-click on the project, choose Export: + = +
+ Export of ESB project + + + + + +
= + = + Choose ESB > ESB File and click Ne= xt: = + = +
Choosing ESB File + + + + + +
= + = + And finally export the ESB project to the file system: choose the = destination, choose the target runtime if need a specific one and make the = appropriate settings for the archive. Then click Finish= . + = +
ESB Export + + + + + +
= + = + Your project is deployed as an .esb archive. + An ESB archive can be created for ESB projects only. It i= s also possible to deploy an .esb archive to a JBoss AS based server with J= Boss ESB installed. = + = + = +
+ = +
+ Creating a ESB File + In this chapter we suggest a step-by-step walk-throu= gh of creating your own + simple file. Let's try to organize a new ESB = file. + + We will show you how to use the Creation wizard for = creating a new ESB file. + + At first you should open any project. Select + File >New > Other... + in the main menu bar or context menu f= or selected project and + then + ESB > ESB File + in the New dialog: + +
+ Select a wizard - ESB File + + + + + +
+ + Clicking + Next + brings you to the wizard page where a = folder, a name and a version for the file should be specified. Choose, for = example, + jboss-esb.xml + as the name and accept the selected pr= ojects folder and the default + version. + = + Note: + From the version 3.1.0 JBoss ESB Tools suppor= ts three different jboss-esb.xsd versions: jbossesb-1.0.1.xsd, jbossesb-1.1= .0.xsd and jbossesb-1.2.0.xsd. + If you use ESB 4.7 you should select jbossesb= -1.2.0.xsd. + + +
+ Folder, Name and Version for ESB file</titl= e> + <mediaobject> + <imageobject> + <imagedata fileref=3D"images/esb_s= upport/02_create_esb.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Thus, your file will be created in the selected proj= ects folder by default. If + you want to change the folder for your future file= click <emphasis> + <property>Browse...</property> + </emphasis> button to set needed folder or simply = type it.</para> + + <para>Clicking on <emphasis> + <property>Finish</property> + </emphasis> results in the file being generated. T= he wizard creates one xml + file.</para> + + </section> + <section id=3D"creating_esb_action"> + <title>Creating a ESB Action + From this chapter you will find out how to create a= ESB Action Java File. + At first you need to open a ESB= or simple Java project. Then you should select File > New>Other in the main menu or fr= om the context project menu. Then click ESB > ESB Acti= on in the New dialog. +
+ Select a wizard - ESB Action + + + + + = + +
+ After that click Next= and you will be brought to the New ESB Acti= on wizard. In this wizard the class name should be sp= ecified, also you can set a package or add a interface as for any Java clas= s. +
+ New ESB Action wizard + + + + + = + +
+ As a result, the ESB Action Java File will be created in the selected package and it will have o= rg.jboss.soa.esb.actions.AbstractActionPipelineProcessor as supe= rclass. + Clicking on Finish will generate the ESB Action class. Also this= class will become available in ESB Editor wizards. +
+ = +
+ Configuring ESB Runtime in Preferences + In this chapter you will know how to predefine a JBo= ss ESB runtime on the Preferences page. + + You may already know, there are two ways to set JBos= s ESB runtime when creating a ESB project, + one is to use the project target JBoss runtime, and anothe= r is to select a JBoss ESB runtime predefined in JBoss Tools preferences. + Let's configure it. + + Select + Window >Preferences > JBos= s Tools > JBoss ESB Runtime + , to open the JBoss ESB Runtime Prefere= nces page where you can add, remove and Edit a JBoss ESB runtime. + +
+ JBoss ESB Runtimes + + + + + +
+ + Select Add to open a dialog where you can specify the JBoss ESB runtime location, n= ame and version number. It's also possible to define configuration if you p= oint the home location to a Jboss AS or SOA-p, in case you select a standal= one ESB runtime location, the configuration combo will be empty and should = be ignored. = + You can also customize the libraries of the runti= me by checking the Customize JBoss ESB Runtime jars checkbox. + = +
+ Configure new JBoss ESB Runtime + + + + + +
+ + The new JBoss ESB Runtime will be configured. Click <= property>OK to finish and save the preferences. + You can use the configuration when creating a JBoss ESB project. + When a ESB runtime is configured for your ESB proje= ct you are able to change it to any other using the classpath container pag= e for ESB runtime. To do that, turn to the Package Explorer view and right-= click the "JBoss ESB Runtime" library. Select Propertie= s and a table listing all available JBoss ESB runtime= s will appear: + = +
+ Classpath Container Page to change ESB run= time + + + + + +
+ = + = + = + Choose one of them to set to the ESB project and cl= ick Ok. + ESB container allows Source and JavaDoc locations t= o be set via the Properties dialog on each contained .jar: right-click on a= ny .jar file, select Properties. = Choose Java Source Attachment and= select location (folder, JAR or zip) containing new source for the chosen = .jar using one of the suggested options (workspace, external folder or file= ) or enter the path manually: + = +
+ Classpath Container: Java Source Attachmen= t + + + + + +
+ Click on Apply an= d then on Ok. + To change Javadoc Location choose Javad= oc Location and specify URL to the documentation gene= rated by Javadoc. The Javadoc location will contain a file called package-list: + = +
+ Classpath Container: Javadoc Location</tit= le> + <mediaobject> + <imageobject> + <imagedata fileref=3D"images/esb_= project/22_Javadoc.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Click on <emphasis><property>Apply</property></emph= asis> and then on <emphasis><property>Ok</property></emphasis>.</para> + = + </section> + + + <section id=3D"using_SOA"> = + <title>Using and Configuring SOA Platform + = + In this chapter you will know what is JBoss Enterpri= se SOA Platform and how you can configure it to use for your ESB projects.= + = + JBoss Enterprise SOA Platform delivers a flexible, s= tandards-based platform to integrate applications, SOA services, business e= vents and automate business processes. The SOA Platform integrates specific= versions of JBoss ESB, jBPM, Drools and the JBoss Enterprise Application P= latform that are certified to work together in a single supported enterpris= e distribution. + Having configured JBoss Enterprise SOA Platform for = your ESB project you don't need to install and configure ESB server and run= time as they are already included. + + Check here to find more details on the platform: JBoss Enterprise SO= A Platform and JBoss Enterprise SOA Platform Component Details.<= /para> + You can find out what is SOA here: Basics of SOA a= nd SO= A and EOA. + = + To configure the JBoss Enterprise SOA platform selec= t + Window > Preferences > Server >= ; Runtime Environments, that will open the Server Run= time Environments Preferences page where you can add, remove and edit a Ser= ver Runtime Environment. + = +
+ Configure new Server Runtime Environment</t= itle> + <mediaobject> + <imageobject> + <imagedata fileref=3D"images/esb_p= roject/13NewServerRuntimeEnv.png"/> + </imageobject> + </mediaobject> + </figure> + = + <para>Select <emphasis><property>Add</property></emphasis>= , choose <emphasis><property>JBoss 4.2 Runtime</property></emphasis> as a t= ype of runtime environment, check the <emphasis><property>Create a new loca= l server</property></emphasis> checkbox and click <emphasis><property>Next<= /property></emphasis>:</para> = + <figure> + <title>Type of Server Runtime Environment + + + + + +
+ = + On the next step you can specify a name of the serve= r runtime environment and browse to its location. Click Finish to add the server runtime environment. + = + = +
+ New Server Runtime Environment Details</tit= le> + <mediaobject> + <imageobject> + <imagedata fileref=3D"images/esb_p= roject/15AddNew.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Now you have your SOA platform configured. To check = the configuration create a ESB Project using instructions described <xref l= inkend=3D"ESB_project_wizard"/>. As a result you will have two projects cre= ated:</para> + = + <figure> + <title>Helloworld Projects Created + + + + + +
+ Then you will need to add JBoss ESB libraries to you= r projects to configure the SOA server runtime exactly for your projects. R= ight-click on your project, select Build Path > Add = Libraries: + = +
+ Add Libraries + + + + + +
+ = + Choose JBoss ESB Libraries and click Next: + = +
+ ESB Libraries + + + + + +
+ = + Select the necessary runtime to add to the project c= lasspath: + = + = +
+ Select a ESB runtime + + + + + +
+ Click Finish. + Now you can deploy your Helloworld project to the s= erver and run a test class in the client Java project to see the test resul= t in the Console view. + = + = + = +
+ = + = + = + = + = + = + = + = + = + = + \ No newline at end of file --===============2572998541147227783==--