Tutorial for building J2EE Applications using JBOSS and ECLIPSE -1

原创 2004年08月30日 17:16:00

Chapter 1

blurulr6.gif

Configuration of ECLIPSE to use JBOSS and LOMBOZ

Install Eclipse.

First of all we have to set up Eclipse Integrated Development Environment (IDE) with JBOSS as our application server.

So go to this page: http://www.eclipse.org/downloads/index.php and download the binary for the Eclipse editor. You can download the appropriate binary for your platform. This tutorial was developed using Linux (Red Hat 8.0) as the operating system.

Example : eclipse-SDK-2.1-linux-gtk.zip, eclipse-SDK-2.1-win32.zip

Note : Eclipse does not include a Java runtime environment (JRE). You will need at least a 1.3 level Java runtime or Java development kit (JDK) installed on your machine in order to run Eclipse.

Now unzip this file into your home directory.

[vishal@localhost eclipse]$ unzip eclipse-SDK-2.1-linux-gtk.zip
Archive: eclipse-SDK-2.1-linux-gtk.zip
Archive: eclipse-SDK-2.1-linux-gtk.zip
inflating: eclipse/plugins/org.eclipse.core.boot_2.1.0/boot.jar
inflating: eclipse/plugins/org.eclipse.core.boot_2.1.0/splash.bmp
inflating: eclipse/plugins/org.eclipse.core.boot_2.1.0/boot.xml
inflating: eclipse/plugins/org.eclipse.core.boot_2.1.0/plugin.properties
-----------------------------------------------------------------------------
----------------------------------------------------------------------------
-------------------------------------------------------------------------
inflating: eclipse/install.ini
inflating: eclipse/startup.jar
inflating: eclipse/readme/readme_eclipse.html


Once you have unzipped this file you will have a directory called 'eclipse' in your home directory.
Go into that directory and run the script file called 'eclipse'.


[vishal@localhost eclipse]$ cd eclipse
[vishal@localhost eclipse]$ ls
cpl-v10.html features install.ini plugins startup.jar
eclipse icon.xpm notice.html readme workspace
[vishal@localhost eclipse]$ ./eclipse



This will run the Eclipse IDE on your workstation. Let's get familiar with this environment.

EclipseIDE.png


Install JBOSS.

Now Eclipse is installed and is running on your workstation, let's install JBOSS.

You can download JBOSS ready to run. Because JBOSS comes with a simple embedded Database (Hypersonic) and a web server (JBossWEB or Tomcat) you can use it out of the box without any initial configuration. Downloads can be accessed from either the JBOSS Project Page on SourceForge where you will always find up to date downloads (http://sourceforge.net/projects/jboss), or from the JBOSS Home Page where you will find useful information about JBoss, the official, free forums, project information etc., and also the download page http://www.jboss.org/downloads.jsp. For this tutorial we are using JBOSS-3.2.1 with the built-in 'Jetty' JBOSSWeb HTTP sever.

Example : jboss-3.2.1.zip (includes JBossWeb HTTP server and JSP/Servlet engine, EJB, CMP2.0, JCA, IIOP, Clustering, JTS, JMX.)

Note : JBOSS does not include a Java runtime environment (JRE).

First login as user 'root' and then unzip this file in a suitable place where you have enough space. I have unzipped it under an /opt/jboss/ directory.

It will create a directory named jboss-3.2.1 under /opt/jboss/.

Before you run JBOSS, in order to check your installation of JBOSS, make sure have you have following environment variables set.

JBOSS_HOME: /opt/jboss/jboss-3.2.1
JAVA_HOME: /usr/java/j2sdk1.4.1_02
CLASSPATH: /usr/java/j2sdk1.4.1_02/lib/tools.jar


Now go into directory jboss-3.2.1 and you will have all these directories.

[root@localhost jboss-3.2.1]# ls
bin client docs lib server

Go into the bin directory and you will find a script named run.sh.

Run this script from the command line. Hopefully it will start, and you will see this message.

15:12:59,876 INFO [Server] JBoss (MX MicroKernel) [3.2.1 (build: CVSTag=JBoss_3_2_1 date=200305041533)] Started in 59s:676ms.

Note: This means that JBOSS is installed and running successfully. Now, it's time to configure it from within the eclipse IDE.

In order to test JBOSS is running correctly, go to your web browser and access this url 'http://localhost:8080/jmx-console/index.jsp'.

Note: This page is referred as the 'JMX Management Console'.

JBOSSWebConsole.png


If you can access this screen from your browser, JBOSS is running successfully.

Note that on this page under the sub-heading of 'jboss' there is a link 'service=Hypersonic'. Go to that link; that will bring up an 'MBean View' page. On this page there is an MBean operation called 'startDatabaseManager'; go there and press the 'Invoke' button. This will bring up the console for the embedded Hypersonic database, from where you can access schemas and do other database management operations.



JBOSSWebDatabaseConsole.png


Creating the Database Schema.

As mentioned in the case study, the schema for our Store's Inventory is composed of five relations. We will load this schema in the Hypersonic embedded database.

In order to that, we will use the following script files.

a) myStoreSchema.script – to create the database schema.

b) myStoreSchema.data – to populate the tables with data.

c) myStoreSchemaDrop.script – to drop/delete all tables used in this tutorial.

Downloads :

myStoreSchema.script

myStoreSchema.data

myStoreSchemaDrop.script



First of all copy these 3 files into the $JBOSS_HOME/server/default/data/hypersonic/ directory. In this example it is /opt/jboss/jboss-3.2.1/server/default/data/hypersonic/

Now access the HSQL Database Manager using the JMX-Management Console shown above.

Note: Please drop/delete any tables already present in the database with same name beforehand, or naturally errors will be raised when you will run these scripts.

On the top level menu of HSQL Database Manager File > Open Script.. > select myStoreSchema.script.



ConfigMystoreSchema.png


After clicking Open > press Execute SQL Statement and the following screen will appear as shown in the figure below.



ConfigMystoreLoadSchemaQuery.png


Go to View > Refresh Tree. If you can see five new tables created then your schema is ready, and it's time to populate them with data.

Go to File > Open Script.. > select myStoreSchema.data > Open.. > Execute SQL Statement.



ConfigMystoreLoadDataQuery.png


Now your data is loaded in the database, in order to verify just execute any query and see the results of that as shown in figure below.

ConfigMystoreLoadDataResult.png


Make sure you 'commit' (Options->commit) to save your schema in the database.

Note : Shutdown Jboss server as we will run it later from inside eclipse.

Install Lomboz.

In order to run JBOSS from within Eclipse you need a plug-in, and for this tutorial we are using Lomboz which is available from http://sourceforge.net/projects/lomboz or from http://www.objectlearn.com/index.jsp.

Note : We are using lomboz.21_02.zip for this tutorial.

Now unzip this file in a temporary directory; you will have a directory named plugins. Go to the directory plugins/com.objectlearn.jdt.j2ee/servers. This directory contains configuration files for various servers. For this tutorial we supply a configuration file for jboss3.2.1 available under downloads.

Note : If there are multiple configuration files the plugin will presently default to the first configuration file within the (eclipse/plugins/com.objectlearn.jdt.j2ee/servers/ ) directory in alphabetical order, so rename all the configuration files to a '.bak'
extension. This is just to avoid slip-ups whilst we're learning.

Now, copy the supplied jboss321all.server file into the servers directory.

cd plugins/
[vishal@localhost plugins]$ ls
com.objectlearn.jdt.j2ee
[vishal@localhost com.objectlearn.jdt.j2ee]$ cd servers
[vishal@localhost servers$ ls
jboss244.server.bak jboss303Tomcat4112.server.bak jboss300all.server.bak jboss321all.server
tomcat403.server.bak weblogic70.server
jboss300.server.bak tomcat410.server x.log


Here's a snippet from the file 'jboss321all.server' used for configuration. For this tutorial we will use this file, which you can download under Downloads.



You can change the various settings in this file according to your environment (e.g. the port number).

Once you have saved this file under the com.objectlearn.jdt.j2ee/servers directory, move the com.objectlearn.jdt.j2ee directory under $HOME/eclipse/plugins/ directory, where $HOME is your home directory.

[vishal@localhost temp/plugins] mv com.objectlearn.jdt.j2ee /home/vishal/eclipse/plugins/.

Now, we will configure Lomboz using this jboss321all.server file.

Note : Now you can now delete the temporary directory.



Lomboz Configuration.

Now run your Eclipse IDE to configure Lomboz ($HOME/eclipse/eclipse ).

Go to Window on top level menu > Open Perspective > Java as shown in fig below.

As we want to customize Java perspective for this tutorial:

EclipseIDEJavaView.png


Go to Window again at top level menu > Customize Perspective > Other.

LombozCustomizePerspective.png


Select Lomboz Actions sub node.

LombozCustomizePerspectiveAction.png


Click OK. Now you will have an icon under your top level menu like this.



LomboZJ2eeIcon.png


Click on this icon will have a Lomboz J2EE View window in your workbench.

LmobozJ2EEView.png


Now, Lomboz J2EE view is available.

Go to Window > Customize Perspective.

Select File > New sub node. Select all nodes starting with Lomboz.

LombozCPJ2eeOptions.png


Select Window > Show view. Select Console, Lomboz J2EE View and others as shown below in figure.

LombozCPJ2eeOptionShowView.png


Now click ok. You will have all those options available from File > New > and Lomboz menu will appear, or by right clicking in the Package Explorer a pop up menu will appear.

EclipseIDELomBozFileMenu.png EclipseIDELomBozPopupMenu.png




Configure JBOSS to run from within Eclipse.

First of all we have to configure the Java Development settings, because Lomboz requires different directories for source and binaries.

Go to Window > Preferences > Java > New Project.

Enter src and bin for the names of these folders, which are the defaults. Please do not modify these names as they are required by some of the Lomboz tasks.

Also, make sure JRE library is set to 'JRE_LIB' variable.

NewProjectConfiguration.png


Go to Window on top level menu > Preferences.

EclipsePreferences.png


Go to the Lomboz node under the Preferences window. Make sure JDK Tools.jar is set to $JAVA_HOME/lib/tools.jar

LombozJDKToolsSelection.png


Go to the server definitions sub node under Lomboz node. Select JBOSS 3.2.ALL under Server types and the rest of the options will be filled after loading the server configuration file which we made for this tutorial.

LombozServerConfig.png


Now, under Server Definitions, go to 'Classpath' and make sure all the paths are correct. If there is a wrong setting for a path, it will show red crosses with jar icons in Server libraries / Client libraries sub section.

LombozClassPathCheck.png


You can add or remove libraries from here. Make sure you 'Apply' the changes after altering the various options.

And now verify your 'Classpath Variables'.

Go to Window > Preferences > Java > Classpath Variables

LombozVerifyClasspath.png


If you get all these Classpath variables right according to your environment.



Test your configuration.

To test your configuration, create a J2EE Project as a test.

Go to File at top level menu > New > Lomboz J2EE Project.

TestProjectWizard.png


Enter 'Test' as project name and press Next.

Check your settings here; if you have 'Test/src' on build path and 'Test/bin' under default output folders then it's ok.

TestProjectConfigSourceWindow.png


Now click on Libraries tab on the Project Creation Wizard.

Because of a bug in Eclipse 2.1 this library is configured wrongly.

So select this library and Remove it.

TestProjectConfigLibraries.png


Now, add a new library > Add Library.. > Select JRE System library > Next .



TestProjectAddLibray.png


Select Default library and press Finish.

TestProjectNewLibrary.png


New library is configured.

Note: You have to repeat this step whenever you are creating a new J2EE Project, as there is a bug in eclipse 2.1.

Now press Next.

Go to Web Module > Add.. > Enter Module Name 'OnlineBank' > Ok.



TestProjectAddWebModule.png


Go to Ejb Modules tab > Add.. > Enter Module Name 'MyBank' > Ok.



TestProjectAddEjbModule.png


Go to Targeted Server > Add.. > 'JBOSS 3.2.1 ALL' .

Note: 'JBOSS 3.2.1 ALL' is not the file name, but the name assigned to server in the 'jboss321all.server' file used for configuration showed above. Snippet from file below.

<serverDefinition
name="JBOSS 3.2.1 ALL"
ejbModules="true"



TestProjectAddTaregetdServer.png


Press Finish.

Now you will have all these directories and libraries under Test Project in the Package Explorer.

Under Project Test 'src' is the directory where all packages for EJB components and Servlets will be developed, that is your java source files.

The 'MyBank' directory is your EJB Module and will have 7 files at start shown in fig below.

The 'OnlineBank' directory is your Web Module and will have 7 files shown in fig below. Your JSP pages will come under this directory for this module.

Note: If you are interested in Ant (from the Jakarta Project) then note that both modules have an Ant 'build.xml' file which is used to build the application.



TestProjectPackageExplorer1.png TestProjectPackageExplorer.png



Now go to top level menu option Window > Show View > Lomboz J2EE View.

Lomboz J2EE view will have Test Project , which has two modules 'MyBank' and 'OnlineBank' using JBOSS 3.2.1 as their default server.

TestProjectLombozJ2eeViwe.png


Now it's time to create an EJB,

Go to File > New > Lomboz EJB creation wizard.

Note: You can access this wizard by right clicking in on project Test in Package Explorer. Go to New > Lomboz EJB creation wizard as explained in the beginning.

Add package name 'au.com.tusc'; you can choose another name if you want. Add 'MySession' in Name. Select Stateless Session EJB option.



TestProjectCreateEjbWizard.png


This will create a file 'MySessionBean.java' under the 'au.com.tusc' package as shown in figure below.

Note: It will generate the bean name, jndi-name and type of bean in the file. Also the name of the file is appended with word 'Bean' as you gave the name of the bean as 'MySession' only. So be careful with naming conventions, as you only need to specify the bean name in the wizard. Don't append the word Bean to the name as the wizard will do that for you.



TestProjectCreateEjb.png


Now we will add a business method via the wizard.

Go to file 'MySessionBean.java' under 'Package Explorer' and expand that, right click on 'MySessionBean' node as shown in the figure below, select New > Lomboz EJB Method wizard.

In the method signature put 'public String learnJ2EE(String messg)', select method type as 'Business Method' and

Interface Type as 'Remote Interface'.

TestProjectSSBBusMethod.png


This will generate the required signature for your business method in your bean class.

Now add this line in this method "Me too! ";

Code Snippet from Bean file







Save the file.  Now we will generate the rest of the files (Home and Remote interfaces along with helper classes, using Xdoclet) required to deploy this bean.

First add this Bean to the module.

Go to Package Explorer > Test > MySessionBean.java > MySessionBean, right click on that; a menu will pop up. Go to Lomboz J2EE on this pop-up menu, and select 'Add EJB to module'.



TestProjectAddEjbToModule.png


Go to Package Explorer > Test > MyBank (which is a directory), right click on that; a menu will pop up.  Go to Lomboz J2EE, which is at the bottom of this pop up menu. Select Generate EJB classes. This will generate the required interfaces, helper classes and files related to deployment; that is, deployment descriptors.



TestProjectCreateEjbClassesWizard.png


It will create a new directory named ejbsrc, which will have a package named au.com.tusc, and under that, remote and home interfaces, along with necessary helper classes, will be generated.

Note: You will not edit any files generated by Xdoclet under 'ejbsrc' directory at any time while doing this tutorial. Because every time you use option Generate EJB Classes, it generates the necessary interfaces and helper classes as mentioned above. These files are generated by Xdoclet, after parsing your bean class, which is created by Lomboz bean creation wizard. Xdoclet looks at the various declared tags and methods in the bean class and then generates files accordingly. As a result, you just add business methods and their implementations in the bean class, and the rest is left to Xdoclet. Hence at any time in the development, you won't need to (and shouldn't!) edit any generated files. It will become clearer as we progress in this tutorial.

Also under MyBank > META-INF directory now there are 15 files, which includes ejb-jar.xml and jboss.xml and ejb-generate.xml. Initially there were only 6 files as noted earlier. These extra files are needed for deployment of the bean.

TestProjectGeneratedEJBClasses.png


Now let us deploy this bean without going into any further details of deployment.

Go to Lomboz J2EE view in your workspace, expand Test > expand MyBank.

You will have au.com.tusc.MySessionBean added to your MyBank EJB module.

Right click on JBOSS 3.2.1 ALL icon as shown in fig below.



TestProjectLombozJ2eeViewSBean.png


A menu will pop up; select option Debug Server.  It will start the server with Debug mode and after successful start it will show this message in the console under your workspace as shown in the figure below.

TestProjectJBOSSConsole.png


Go to Lombo J2EE View > expand Test > select MyBank and right click on that; a menu will pop up; select option Deploy.

TestProjectLombozJ2eeViewDeploy.png


Once the bean is deployed, a message will come in your 'Console' confirming that, as shown in the figure below.

TestProjectLombozJ2EEBeanDeploy.png


Now we will create a client to access this bean deployed on JBOSS (application sever).

Go to Package Explorer > Test > src, right click on that, a menu will pop up > select EJB Test client.

Enter Package name 'test' and Client name as 'Client'.

TestClientAddHome.png


Select EjbHome as 'MySessionHome' and Ejb Interface as 'MySession' > Finish as shown in the figure below.

TestClientWizardFinish.png


Now the client is generated, it's time to call business methods on the deployed bean.

We need some code to invoke the method on the bean..

TestClientFileView.png


Go to Client.java and write these lines under the 'testBean()' method.

String request = "I'm tired of 'Hello, world' examples..";

System.out.println("Request from client : " + request);

System.out.println("Message from server : " + myBean.learnJ2EE(request) );

Code Snippet from Client.java.


















Now first select Client node under Package Explorer. Go to top level menu and select this icon as shown below.

TestClientRunIcon.png
On this icon go to > Run as > Java Application.

TestClientRun.png


Your Client is going to make a request, the results of which will be displayed in the console under your workspace, as shown below.


TestClientResult.png

Note: Ignore these exceptions regarding org.apache.log4j.Property as it requires 'log4j.properties' on the clients path. We will cover this later on as this doesn't affect the functioning of the bean.


You have successfully created a bean and invoked an operation on it. Now, let's have a brief overview of J2EE concepts in the next chapter, before we start implementing the case study.

图像处理与计算机视觉基础,经典以及最近发展

图像处理与计算机视觉基础,经典以及最近发展本文的安排如下。第一部分是绪论。第二部分是图像处理中所需要用到的理论基础,主要是这个领域所涉及到的一些比较好的参考书籍。第三部分是计算机视觉中所 涉及到的信号...
  • bluecol
  • bluecol
  • 2015年10月26日 16:24
  • 2652

Java连接mysql中遇到的一些问题及解决方法

0.要想用Java连接mysql数据库,首先装好JDK,配置好环境变量,将jdk*.*.*\lib放入classpath,将jdk*.*.*\bin放入path中(*.*.*表示版本号);其次安装好m...
  • zdf19931993
  • zdf19931993
  • 2016年05月03日 20:38
  • 13133

个人阅读的Deep Learning方向的paper整理

http://hi.baidu.com/chb_seaok/item/6307c0d0363170e73cc2cb65 个人阅读的Deep Learning方向的paper整理,分了几部分吧...
  • sunmenggmail
  • sunmenggmail
  • 2014年03月10日 10:42
  • 19664

Tutorial_for_building_J2EE_Applications_using_JBOSS_and_ECLIPSE

  • 2007年04月13日 07:37
  • 6.47MB
  • 下载

Tutorial.for.building.J2EE.Applications.using.JBOSS.and.ECLIPSE

  • 2011年07月27日 10:00
  • 5.67MB
  • 下载

Building Applications using J2EE 1.4.pdf

  • 2009年01月09日 09:25
  • 224KB
  • 下载

Building Scalable and High-performance Java Web Applications Ssing J2EE Technology.pdf

  • 2007年03月15日 16:43
  • 5.18MB
  • 下载

Eclipse+Lomboz+JBoss搭建J2EE开发环境记录

  • 2008年04月07日 15:19
  • 2.18MB
  • 下载

Eclipse Juno(j2ee)开发环境下JBoss热部署的实现方式(暴露式部署,WTP)

如果对部署方式有疑问,请先看这个帖子: JBoss和Tomcat部署方式的区别(解释暴露式部署) 我们说一下Eclipse J2ee版本(下个WTP插件也行)自带的run on server功能,支...
  • wwwcomy
  • wwwcomy
  • 2015年10月13日 15:05
  • 576

Eclipse集成 Lomboz和JBoss开发J2EE

  • 2011年10月29日 21:50
  • 351KB
  • 下载
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Tutorial for building J2EE Applications using JBOSS and ECLIPSE -1
举报原因:
原因补充:

(最多只允许输入30个字)