|
This article provides instructions for deploying WebORB into a Java
Application Server. WebORB is registered as a servlet, as a result, the
container must support the Servlet API v2.3 or above. There are two ways to
deploy WebORB:
- WebORB can be deployed as a
new web application. This deployment
provides a separate web application with all the WebORB functionality
available out of the box. User classes must be deployed into the application
to enable them for remote access. WebORB distribution includes weborb.war and
weborb.ear files. Most Java containers support automatic application
deployment from the war or ear file. Use the links below for instructions
specific to a particular container:
- WebORB can be deployed into an
existing web application. This
requires additional configuration steps to register product servlets and add
WebORB configuration and binary files. As soon as WebORB is deployed,
application classes are automatically available to Flex, Flash and AJAX
clients.
Follow the steps below to deploy the product into an existing web
application: Minimal deployment
(only POJO remoting, no console,
examples, data management, spring support, etc)
- Copy weborb-config.xml
from:
[WEBORB_INSTALL]\webapp\WEB-INF\classes
to
[YOUR APP PATH]\WEB-INF\classes
- Copy weborb.jar
from:
[WEBORB_INSTALL]
to
[YOUR APP PATH]\WEB-INF\lib
- Modify web.xml from
WEB-INF of your web application to include the
following:
<servlet>
<servlet-name>weborb</servlet-name>
<servlet-class>weborb.ORBServlet</servlet-class>
<load-on-startup> 1 </load-on-startup>
</servlet>
<servlet>
<servlet-name>download</servlet-name>
<servlet-class>weborb.DownloadServlet</servlet-class>
<load-on-startup> 1 </load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>download</servlet-name>
<url-pattern>/codegen.wo</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>weborb</servlet-name>
<url-pattern>*.wo</url-pattern>
</servlet-mapping>
- Create \flex directory under
WEB-INF in your web application.
Copy
all files from:
[WEBORB_INSTALL]\webapp\WEB-INF\flex
to
[YOUR APP PATH]\WEB-INF\flex
WebORB Management Console deployment
- Follow the steps from the "Minimal
deployment" section.
- Copy weborbconsole.html
from:
[WEBORB_INSTALL]\webapp
to
[DOC ROOT OF YOUR APPLICATION]
- Copy all files from the console folder
from:
[WEBORB_INSTALL]\webapp\console
to
[DOC ROOT OF YOUR APPLICATION]\console
- Copy all files from the weborbassets folder
from:
[WEBORB_INSTALL]\webapp\weborbassets
to
[DOC ROOT OF YOUR APPLICATION]\weborbassets
- Once deployed, the console is available at the following path:
http://localhost:[port]/[app-context-path]/weborbconsole.html
Spring Framework Integration
- Follow the steps from the "Minimal
deployment" section.
- Deploy Spring deployment file to the
/WEB-INF directory of your web
application. For the simplicity of instructions, assume the file name is
applicationContext.xml
- Modify web.xml from WEB-INF of your web application to include the
following:
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/applicationContext.xml</param-value>
</context-param>
<listener>
<listener-class>
org.springframework.web.context.ContextLoaderListener
</listener-class>
</listener>
- Copy the following jar files:
[WEBORB_INSTALL]\webapp\WEB-INF\lib\spring-beans.jar
[WEBORB_INSTALL]\webapp\WEB-INF\lib\spring-context.jar
[WEBORB_INSTALL]\webapp\WEB-INF\lib\spring-core.jar
[WEBORB_INSTALL]\webapp\WEB-INF\lib\spring-web.jar
to
[YOUR APP PATH]\WEB-INF\lib\
- Once deployed, you can see the Spring beans in Management Console's
service browser (select the Management tab)
|
|