The product offers samples that demonstrate common enterprise
application tasks. Many samples also provide instructions for deployment
and coding examples.
The product provides samples in two ways:
- Plants By WebSphere sample installed with the product
- If you select to install samples when installing the product and
when creating an application server profile, the Plants By WebSphere
application is included with the product. The application demonstrates
several Java Platform, Enterprise Edition
(Java EE) functions, using an online store that specializes in plant
and garden tool sales.
See Installing
the Plants By WebSphere sample.
- Samples downloadable from the Samples, Version 8.5 information
center
- The product provides component-specific samples that you can download
at any time from a download site.
Installing the Plants By WebSphere sample
To install the Plants By WebSphere sample, perform the following
steps.
- Install the product.
Plants By WebSphere sample is installed in the app_server_root/samples directory. A Plants By WebSphere pre-built enterprise
archive named pbw-ear.ear is in the /samples/PlantsByWebSphere/pbw-ear/target directory.
Installation instructions are in the /samples/PlantsByWebSphere/docs directory.
You can build or modify the sample source code
to support your project. The source code is in a src directory.
- To run the sample in a distributed WebSphere® Application Server, Network Deployment environment,
install and configure the samples in a stand-alone application server
profile installation, and then add the stand-alone application server
profile as a managed node of the deployment manager cell.
You can use a deployment manager administrative console or wsadmin addNode command to make an application server a managed
node of a deployment manager. For the wsadmin addNode command, use the dmgr_host argument with the -includeapps and -includebuses
options.
![[IBM i]](../images/iseries.gif)
For example:
addNode dmgr_hostname -includeapps -includebuses
where dmgr_hostname is name of the computer
that hosts your deployment manager profile.
- Start the application server.
Available samples
Samples
that you can download include, for example, the following materials:
- Communications Enabled Applications (CEA) samples
- The CEA sample applications provide two main services, telephony
access and multi-modal web interaction. Use this collection of sample
applications to explore the services and to use as a starting point
when developing your own communication enabled applications.
- OSGi samples
- The OSGi samples help you develop and deploy modular applications
that use both Java EE and OSGi technologies.
- XML samples
- The XML samples demonstrate use of the XML API and supported specifications.
- Internationalization service sample
- The Internationalization service sample demonstrates how to use
the internationalization service in Java EE applications, specifically
within servlets and enterprise beans.
- Web services samples
These samples demonstrate both Java API for XML-based RPC (JAX-RPC)
and Java API for XML Web Services (JAX-WS) web services that use Java
Platform, Enterprise Edition (Java EE) beans and JavaBeans components.
The JAX-WS web service samples demonstrate
the implementation of one-way and two-way web services that highlight
the use of web services standards such as WS-Addressing (WS-A) , WS-Reliable
Messaging (WS-RM), and WS-Secure Conversation (WS-SC) and the SOAP
Message Transmission Optimization Mechanism (MTOM) technology.
- Service Data Objects (SDO) sample
- This sample demonstrates data access to a relational database
through Service Data Objects (SDO) and Java DataBase Connectivity
(JDBC) Mediator technologies.
Downloading samples
You
can download samples from the
Samples, Version 8.5 information center.
- Go to the Samples, Version 8.5 information
center.
- Determine which samples you want to download.
- On the Downloads tab for the samples that
you want, click a Download Sample link.
- In the authentication window, click OK.
- Download the compressed file, or individual sample files, to a
directory on your workstation.
You might create the /samples/sample_type directory path on your workstation
and download the sample files to that directory path.
Many sample compressed files have an /installableApps directory that contains deployable prebuilt archives. Other directories
contain files such as sample-specific source archives, scripts, and
instructions for building deployable archives.
Limitations of the samples
- The samples are for demonstration purposes only.
The code that
is provided is not intended to run in a secured production environment.
The samples support Java 2 Security, therefore the samples implement
policy-based access control that checks for permissions on protected
system resources, such as file I/O.
The samples also support
administrative security.
- Many of the samples connect to an Apache Derby
database using the embedded framework of Apache Derby. The embedded
framework of Apache Derby has a limitation that only one Java virtual
machine (JVM) can access a given database instance. As a result, in
a clustered application server environment, the second server in the
node fails to start the sample applications, because the first server
(JVM) already holds a connection to that database instance.
For
applications that require multiple Java virtual machines to access
the same Apache Derby instance, use the Apache Derby networkServer
framework.
Additional samples and examples
- Samples on developerWorks®
- Additional product samples are available on WebSphere developerWorks
- Samples in tutorials
- Many product tutorials rely on sample code. To find tutorials
that demonstrate specific technologies, browse the links in Tutorials.
- Examples in the product documentation
- The product documentation contains many code snippets and examples.
To locate these examples easily, see the developer examples in the Reference section of the information center navigation
for the product edition that you are using.
IBM Telephone Directory
- The IBM Telephone Directory business application is shipped separately
from the product. For information about obtaining and using the IBM
Telephone Directory application, see IBM Telephone Directory V5.2 in the topic on
e-business and web serving in the IBM i information center.