Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "EclipseLink/UserGuide/DBWS/Overview/Design time"

Line 16: Line 16:
 
* <tt>JAVA_HOME</tt>
 
* <tt>JAVA_HOME</tt>
 
* <tt>DRIVER_CLASSPATH</tt>  
 
* <tt>DRIVER_CLASSPATH</tt>  
 +
 +
==== Command-line arguments ====
 
<source lang="text" enclose=div>
 
<source lang="text" enclose=div>
 
DBWSBuilder usage - [] indicates optional argument:
 
DBWSBuilder usage - [] indicates optional argument:

Revision as of 17:29, 7 December 2011


EclipseLink DBWS

Eclipselink-logo.gif
EclipseLink
Website
Download
Community
Mailing ListForumsIRCmattermost
Issues
OpenHelp WantedBug Day
Contribute
Browse Source


Creating EclipseLink DBWS Services using the DBWSBuilder utility

The EclipseLink DBWS design-time utility DBWSBuilder is a Java application that processes an EclipseLink DBWS builder XML file to produce a deployable archive (typically a .war file) containing all the required deployment artifacts (WSDL, .xsd schema, web.xml, etc.) for a JAX-WS 2.0 compliant Web Service. There are script files provided for invoking DBWSBuilder. They are located in the <ECLIPSELINK_HOME>\utils\dbws directory. The scripts ending in .cmd are for Windows use while those that end with .sh are for all other operating systems. Before running the dbwsbuilder.cmd script, please ensure that the following environment variables in the <ECLIPSELINK_HOME>\utils\dbws\setenv.cmd (or setenv.sh file) are set:

  • JAVA_HOME
  • DRIVER_CLASSPATH

Command-line arguments

DBWSBuilder usage - [] indicates optional argument:
prompt > dbwsbuilder.cmd  -builderFile {path_to_dbws_builder.xml} -stageDir  {path_to_stageDir} -packageAs[:archive_flag - archive, noArchive, ignore] {packager} [additional args]
Available packagers:
    -packageAs:[default=not supported] jdev
    -packageAs:[default=archive] javase [jarFilename]
    -packageAs:[default=archive] wls [warFilename] [warFilename]
    -packageAs:[default=archive] glassfish [warFilename] [warFilename]
    -packageAs:[default=archive] jboss [warFilename] [warFilename]
    -packageAs:[default=archive] war [warFilename] [warFilename]
    -packageAs:[default=archive] was [warFilename] [warFilename]
    -packageAs:[default=not supported] eclipse

Typical .war file layout:

root of war file
   \---WEB-INF
   |
   |   web.xml
   |
   +---classes
   |   +---META-INF
   |   |       eclipselink-dbws.xml
   |   |       eclipselink-dbws-or.xml
   |   |       eclipselink-dbws-ox.xml
   |   |       eclipselink-dbws-sessions.xml
   |   |
   |   \---_dbws
   |           DBWSProvider.class     -- auto-generated JAX-WS 2.0 Provider
   |           ProviderListener.class -- auto-generated Servlet Listener
   |
   \---wsdl
           eclipselink-dbws-schema.xsd
           eclipselink-dbws.wsdl
           swaref.xsd                 -- optional

Back to the top