Jump to: navigation, search

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

Line 35: Line 35:
 
<source lang="text">
 
<source lang="text">
 
DBWSBuilder usage - [] indicates optional argument:
 
DBWSBuilder usage - [] indicates optional argument:
prompt > dbwsbuilder.cmd -builderFile {path_to_builder.xml} -stageDir {path_to_stageDir} -packageAs[:archive_flag] {packager} [additional args]
+
prompt > dbwsbuilder.cmd -builderFile {path_to_dbws_builder.xml} -stageDir {path_to_stageDir} -packageAs[:archive_flag - archive, noArchive, ignore] {packager} [additional args]
 
Available packagers:
 
Available packagers:
  -packageAs:[default=archive] javase [jarFilename]
+
Available packagers:
  -packageAs:[default=archive] wls [warFilename]
+
    -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
 
</source>
 
</source>
 
Using <tt>DBWSBuilder</tt>, you can generate an EclipseLink DBWS service from the following sources:
 
* [[EclipseLink/UserGuide/DBWS/Creating_from_a_Database_Table|an existing relational database table]]
 
* [[EclipseLink/UserGuide/DBWS/Creating_from_a_SQL_Statement|one or more SQL <tt>SELECT</tt> statements]]
 
* [[EclipseLink/UserGuide/DBWS/Creating_from_a_Stored_Procedure|a stored procedure]]
 
* [[EclipseLink/UserGuide/DBWS/Creating_from_a_Stored_Function|a stored function]]
 

Revision as of 17:09, 7 December 2011

EclipseLink DBWS

link="http://wiki.eclipse.org/EclipseLink"
EclipseLink
Website
Download
Community
Mailing ListForumsIRC
Bugzilla
Open
Help Wanted
Bug Day
Contribute
Browse Source


Creating EclipseLink DBWS Services using the DBWSBuilder utility

The EclipseLink DBWS design-time utility DBWSBuilder is used to create a deployable archive. DBWSBuilder is a Java application that processes an EclipseLink DBWS builder XML file to produce all the required deployment artifacts (WSDL, .xsd schema, web.xml, eclipselink-dbws-or.xml, etc). Typical .war archive file layout:

root of war file
   \---web-inf
   |
   |   web.xml
   |
   |   +---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
   |
   \---wsdl
           eclipselink-dbws-schema.xsd
           eclipselink-dbws.wsdl
           swaref.xsd                        -- optional

Be sure to set the following environment variables in the <ECLIPSELINK_HOME>\utils\dbws\setenv.cmd (or setenv.sh file) before invoking DBWSBuilder:

  • JAVA_HOME
  • DRIVER_CLASSPATH

There are script files provided for invoking DBWSBuilder. They are located in the <ECLIPSELINK_HOME>\utils\dbws directory. The scripts are dbwsbuilder.cmd for Windows usage, and dbwsbuilder.sh for other operating systems.

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:
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