Modified: webservices/axis2/site/tools/1_1/eclipse/servicearchiver-plugin.html URL: http://svn.apache.org/viewvc/webservices/axis2/site/tools/1_1/eclipse/servicearchiver-plugin.html?rev=652665&r1=652664&r2=652665&view=diff ============================================================================== --- webservices/axis2/site/tools/1_1/eclipse/servicearchiver-plugin.html (original) +++ webservices/axis2/site/tools/1_1/eclipse/servicearchiver-plugin.html Thu May 1 14:20:27 2008 @@ -1,82 +1,82 @@ -Axis2/Java - Service Archive Generator Wizard Guide for Eclipse Plug-in

Service Archive Generator Wizard Guide for Eclipse Plug-in

This document will guide you through the installation and usage of the -archive generator Eclipse plug-in.

[Download Plugin Tool]

Introduction

As part of the Axis2 tool set, the service archive generator is an -important tool that allows the generation of service archives ("aar" file or -a "jar" files) that can be deployed as a web services to the Axis2.

Installation

One can easily download the plugin

If one needs to build the plug-in from source, Maven2 and Ant builds arevailabe. -Please refer the readme.txt located at module/tools on Axis2 source.

Once you've obtained the plug-in just unzip the content of the plug-in -archive to the Eclipse plug-in directory (if it is the zipped-binary version) -or copy the necessary folders to the Eclipse plug-in directory and restart -Eclipse.

NOTE : This plug-in works on Eclipse version 3.1 and -upwards, also the java version should be 1.4 or higher. The provided screen shots -may slightly differ with what the user would actually see but the functionality -has not been changed.

Operation

If the plug-in is properly installed you should see a new wizard under the -"New" section. (Use the File -> New -> Other or Ctrl + N )

Selecting the wizard and pressing the "Next" button will start the service -generator wizard. Following is the first page of the wizard.

Page 1:

Once the class file folder (which should be a folder in the file system) -is browsed and selected, the "Next" button will be enabled and you can move to -the next page. Note that you have the option of either including all the -files or the class files only of the folder on page 1.

Page 2:

Page 2 of the wizard as seen below requires you to locate/browse the WSDL -file. If you do not wish to add a WSDL file to the service archive, select skip WSDL, else you can -select the location of the WSDL file by selecting the select WSDL option.

Page 3:

Select the services.xml file on this wizard page by browsing or select the -option of generating service xml automatically, after which you can click -"Next" button to go to the next page. Notice how the browsing option disables -when the "Generate service xml automatically" check box is ticked.

- -

Page 4:

- -

The next step is to add the libraries. The library addition page looks -like this :

The library name (with full path) can be either typed on the text box or -browsed for using the "Browse" button.

Once there is a library name with full path on the text box, hit the "Add" -button to add the library to the list. Added libraries should be displayed in -the "Added libraries" list box. This way you can add as many external -libraries as you wish. See the screen shots below.

If any added library needs to be removed, highlight it or in other words, -select it from the "Added libraries" list and hit on the "Remove" button as shown -below. Click on the "Next" button to proceed to the last page of the wizard if the -user did not select to auto generate the services.xml file. If user select to auto -generate the services.xml file then the services.xml option page will be displayed.

Page 5:

This page only appears if the user select to generate the services.xml at page 3 -of the wizard. If the user have selected a services.xml then the user will be directed -to the last page of the wizard.

After entering the correct service name and valid fully qualified class name, -try to load the existing methods of that class by clicking the load button.

If successfully loaded the user will be presented with a table at the -bottom of the page with the details of the loaded class. By checking and unchecking -the user can select the necessary methods to include in the services.xml

By clicking on the search declared method only check box, the user can remove the -inherited methods from the class. Click on the "Next" button to proceed to the last page of the wizard

Page 6:

The last page of the wizard asks for the output file location and the -output archive file name. To be able to finish the wizard, user must enter -valid output file location and output file name.

Once all the parameters are filled, hit the "Finish" button to complete the -wizard and generate the service archive.

If you see the above message, then you've successfully generated the -service archive! This service archive can be hot deployed (deployed at run -time) to the axis2

Appendix

    -
  • Eclipse reference - - http://www.eclipse.org/
  • -
  • Custom Ant Tasks  - http://ant.apache.org/manual/develop.html
  • +Axis2/Java - Service Archive Generator Wizard Guide for Eclipse Plug-in

    Service Archive Generator Wizard Guide for Eclipse Plug-in

    This document will guide you through the installation and usage of the +archive generator Eclipse plug-in.

    [Download Plugin Tool]

    Introduction

    As part of the Axis2 tool set, the service archive generator is an +important tool that allows the generation of service archives ("aar" file or +a "jar" files) that can be deployed as a web services to the Axis2.

    Installation

    One can easily download the plugin

    If one needs to build the plug-in from source, Maven2 and Ant builds arevailabe. +Please refer the readme.txt located at module/tools on Axis2 source.

    Once you've obtained the plug-in just unzip the content of the plug-in +archive to the Eclipse plug-in directory (if it is the zipped-binary version) +or copy the necessary folders to the Eclipse plug-in directory and restart +Eclipse.

    NOTE : This plug-in works on Eclipse version 3.1 and +upwards, also the java version should be 1.4 or higher. The provided screen shots +may slightly differ with what the user would actually see but the functionality +has not been changed.

    Operation

    If the plug-in is properly installed you should see a new wizard under the +"New" section. (Use the File -> New -> Other or Ctrl + N )

    Selecting the wizard and pressing the "Next" button will start the service +generator wizard. Following is the first page of the wizard.

    Page 1:

    Once the class file folder (which should be a folder in the file system) +is browsed and selected, the "Next" button will be enabled and you can move to +the next page. Note that you have the option of either including all the +files or the class files only of the folder on page 1.

    Page 2:

    Page 2 of the wizard as seen below requires you to locate/browse the WSDL +file. If you do not wish to add a WSDL file to the service archive, select skip WSDL, else you can +select the location of the WSDL file by selecting the select WSDL option.

    Page 3:

    Select the services.xml file on this wizard page by browsing or select the +option of generating service xml automatically, after which you can click +"Next" button to go to the next page. Notice how the browsing option disables +when the "Generate service xml automatically" check box is ticked.

    + +

    Page 4:

    + +

    The next step is to add the libraries. The library addition page looks +like this :

    The library name (with full path) can be either typed on the text box or +browsed for using the "Browse" button.

    Once there is a library name with full path on the text box, hit the "Add" +button to add the library to the list. Added libraries should be displayed in +the "Added libraries" list box. This way you can add as many external +libraries as you wish. See the screen shots below.

    If any added library needs to be removed, highlight it or in other words, +select it from the "Added libraries" list and hit on the "Remove" button as shown +below. Click on the "Next" button to proceed to the last page of the wizard if the +user did not select to auto generate the services.xml file. If user select to auto +generate the services.xml file then the services.xml option page will be displayed.

    Page 5:

    This page only appears if the user select to generate the services.xml at page 3 +of the wizard. If the user have selected a services.xml then the user will be directed +to the last page of the wizard.

    After entering the correct service name and valid fully qualified class name, +try to load the existing methods of that class by clicking the load button.

    If successfully loaded the user will be presented with a table at the +bottom of the page with the details of the loaded class. By checking and unchecking +the user can select the necessary methods to include in the services.xml

    By clicking on the search declared method only check box, the user can remove the +inherited methods from the class. Click on the "Next" button to proceed to the last page of the wizard

    Page 6:

    The last page of the wizard asks for the output file location and the +output archive file name. To be able to finish the wizard, user must enter +valid output file location and output file name.

    Once all the parameters are filled, hit the "Finish" button to complete the +wizard and generate the service archive.

    If you see the above message, then you've successfully generated the +service archive! This service archive can be hot deployed (deployed at run +time) to the axis2

    Appendix


    \ No newline at end of file Modified: webservices/axis2/site/tools/1_1/eclipse/wsdl2java-plugin.html URL: http://svn.apache.org/viewvc/webservices/axis2/site/tools/1_1/eclipse/wsdl2java-plugin.html?rev=652665&r1=652664&r2=652665&view=diff ============================================================================== --- webservices/axis2/site/tools/1_1/eclipse/wsdl2java-plugin.html (original) +++ webservices/axis2/site/tools/1_1/eclipse/wsdl2java-plugin.html Thu May 1 14:20:27 2008 @@ -1,91 +1,91 @@ -Axis2/Java - Code Generator Wizard Guide for Eclipse Plug-in

    Code Generator Wizard Guide for Eclipse Plug-in

    This document explains the usage of this code generator plug-in for -Eclipse. In other words, this document will guide you through the operations -of generating a WSDL file from a Java class and/or generating a Java class -file from a WSDL file.

    [Download Plugin Tool]

    Introduction

    The Axis2 code generator comes built-in with an Eclipse plug-in. This plug-in can be used -to generate a WSDL file from a java class (Java2WSDL) and/or a java class -file from a WSDL (WSDL2Java). First you need to install the plug-in. The -instructions for the installation process are given below.

    Installation

    One can easily download the plugin

    If one needs to build the plug-in from source, Maven2 and Ant builds arevailabe. -Please refer the readme.txt located at module/tools on Axis2 source.

    Once you've obtained the plug-in just unzip the content of the plug-in -archive to the Eclipse plug-in directory (if it is the zipped-binary version) -or copy the necessary folders to the Eclipse plug-in directory and restart -Eclipse.

    NOTE : This plug-in works on Eclipse version 3.1 and -upwards, also the java version should be 1.4 or higher. The provided screen shots -may slightly differ with what the user would actually see but the functionality -has not been changed.

    Operation - WSDL2Java

    If the plug-in is properly installed you should see a new wizard under the -"New" section.(use the File -> New -> Other or Ctrl + N )

    Selecting the wizard and pressing the "Next" button will start the code -generator wizard. Following is the first wizard page.

    Page 1:

    Selecting the "Generate Java source code from WSDL file" option and -clicking "Next" leads to the following page.

    WSDL2Java Page 2 :

    To move on to the next page the WSDL file location must be given. The -"Browse" button can be used to easily browse for a file rather than typing the -whole path.

    WSDL2Java Page 3 :

    Once the WSDL file is selected, the next page will take you to the page -from where codegen options are to be selected. By far this -is the most important page in this wizard. This page determines the -characteristics of the code being generated.

    Novices need not worry about these options since the most common options -are defaulted, but advanced users will find it very easy to turn the knobs -using these options.

    What advanced users can do is select custom from the select codegen options -drop down list and then change/edit the fields that you need.

    Once the options are selected, only the final step of the code generation -is left which is the selection of the output file location.

    WSDL2Java Page 4 :

    Here you can select the output file path by typing or browsing using the -"Browse" button. You have the option of browsing only eclipse workspace projects by -selecting the "Add the source to a project on current eclipse workspace" radio button. -Or else you have the option to save the codegen resutls to file system

    Here also you have the option to add some value to the codegen results. -If you have enabled the check box "Add Axis2 libraries to the codegen result project" -then all other controls below will get enabled. What you can do is point the downloaded -Axis2_HOME location via the "Browse" button. Then you can verify the availability of the Axis2 -libs by clicking on the "Check Libs" button. If all goes well then you can add the axis 2 libs -to the codegen results location. Another option is available to generate a jar file if the user -needs to add the codegen results to a project as a compiled jar file to the selected locations -lib directory.

    When the output file location is selected, the "Finish" button will be -enabled. Clicking the "Finish" button will generate the code and a message box -will pop up acknowledging the success. Well Done! You've successfully -completed Axis2 code generation.

    Operation - Java2WSDL

    Page 1:

    For this operation you need to select the option which says "Generate a -WSDL from a Java source file"

    Then click the "Next" button which will lead to the next page below.

    Java2WSDL Page 2:

    In this page one needs to select the class to be exposed and the relevant -jar files /classes to be loaded as the classpath. After the libraries have -been set, the "Test Class Loading" button must be clicked in order to test -whether the class is loadable. Unless the class loading is successful -proceeding to the "Next" button will not be enabled.

    Once the classloading is successful and "Next" button is clicked the page -below will appear.

    Java2WSDL Page 3:

    This page allows the parameters to be modified by setting the options for -the generator.

    Java2WSDL Page 4:

    Here you can select the output file path by typing or browsing using the -"Browse" button. You have the option of browsing only Eclipse workspace projects by -selecting the "Add the source to a project on current eclipse workspace" radio button -. Or else you have the option to save the codegen resutls to file system. Once the -output file location and the output WSDL file name is added you can click the "Finish" -button to complete generation.

    If a message box pops up acknowledging the success, then you've -successfully completed the Java2WSDL code generation.

    Appendix

      -
    • Eclipse reference - - http://www.eclipse.org/
    • -
    • Custom Ant Tasks  - - http://ant.apache.org/manual/develop.html
    • +Axis2/Java - Code Generator Wizard Guide for Eclipse Plug-in

      Code Generator Wizard Guide for Eclipse Plug-in

      This document explains the usage of this code generator plug-in for +Eclipse. In other words, this document will guide you through the operations +of generating a WSDL file from a Java class and/or generating a Java class +file from a WSDL file.

      [Download Plugin Tool]

      Introduction

      The Axis2 code generator comes built-in with an Eclipse plug-in. This plug-in can be used +to generate a WSDL file from a java class (Java2WSDL) and/or a java class +file from a WSDL (WSDL2Java). First you need to install the plug-in. The +instructions for the installation process are given below.

      Installation

      One can easily download the plugin

      If one needs to build the plug-in from source, Maven2 and Ant builds arevailabe. +Please refer the readme.txt located at module/tools on Axis2 source.

      Once you've obtained the plug-in just unzip the content of the plug-in +archive to the Eclipse plug-in directory (if it is the zipped-binary version) +or copy the necessary folders to the Eclipse plug-in directory and restart +Eclipse.

      NOTE : This plug-in works on Eclipse version 3.1 and +upwards, also the java version should be 1.4 or higher. The provided screen shots +may slightly differ with what the user would actually see but the functionality +has not been changed.

      Operation - WSDL2Java

      If the plug-in is properly installed you should see a new wizard under the +"New" section.(use the File -> New -> Other or Ctrl + N )

      Selecting the wizard and pressing the "Next" button will start the code +generator wizard. Following is the first wizard page.

      Page 1:

      Selecting the "Generate Java source code from WSDL file" option and +clicking "Next" leads to the following page.

      WSDL2Java Page 2 :

      To move on to the next page the WSDL file location must be given. The +"Browse" button can be used to easily browse for a file rather than typing the +whole path.

      WSDL2Java Page 3 :

      Once the WSDL file is selected, the next page will take you to the page +from where codegen options are to be selected. By far this +is the most important page in this wizard. This page determines the +characteristics of the code being generated.

      Novices need not worry about these options since the most common options +are defaulted, but advanced users will find it very easy to turn the knobs +using these options.

      What advanced users can do is select custom from the select codegen options +drop down list and then change/edit the fields that you need.

      Once the options are selected, only the final step of the code generation +is left which is the selection of the output file location.

      WSDL2Java Page 4 :

      Here you can select the output file path by typing or browsing using the +"Browse" button. You have the option of browsing only eclipse workspace projects by +selecting the "Add the source to a project on current eclipse workspace" radio button. +Or else you have the option to save the codegen resutls to file system

      Here also you have the option to add some value to the codegen results. +If you have enabled the check box "Add Axis2 libraries to the codegen result project" +then all other controls below will get enabled. What you can do is point the downloaded +Axis2_HOME location via the "Browse" button. Then you can verify the availability of the Axis2 +libs by clicking on the "Check Libs" button. If all goes well then you can add the axis 2 libs +to the codegen results location. Another option is available to generate a jar file if the user +needs to add the codegen results to a project as a compiled jar file to the selected locations +lib directory.

      When the output file location is selected, the "Finish" button will be +enabled. Clicking the "Finish" button will generate the code and a message box +will pop up acknowledging the success. Well Done! You've successfully +completed Axis2 code generation.

      Operation - Java2WSDL

      Page 1:

      For this operation you need to select the option which says "Generate a +WSDL from a Java source file"

      Then click the "Next" button which will lead to the next page below.

      Java2WSDL Page 2:

      In this page one needs to select the class to be exposed and the relevant +jar files /classes to be loaded as the classpath. After the libraries have +been set, the "Test Class Loading" button must be clicked in order to test +whether the class is loadable. Unless the class loading is successful +proceeding to the "Next" button will not be enabled.

      Once the classloading is successful and "Next" button is clicked the page +below will appear.

      Java2WSDL Page 3:

      This page allows the parameters to be modified by setting the options for +the generator.

      Java2WSDL Page 4:

      Here you can select the output file path by typing or browsing using the +"Browse" button. You have the option of browsing only Eclipse workspace projects by +selecting the "Add the source to a project on current eclipse workspace" radio button +. Or else you have the option to save the codegen resutls to file system. Once the +output file location and the output WSDL file name is added you can click the "Finish" +button to complete generation.

      If a message box pops up acknowledging the success, then you've +successfully completed the Java2WSDL code generation.

      Appendix


      \ No newline at end of file --------------------------------------------------------------------- To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org For additional commands, e-mail: axis-cvs-help@ws.apache.org