Eclipse+Weblogic 12开发简单的Enterprise Application

学到EJB方面的内容,遇到了很多问题,翻阅了无数遍Java EE和Weblogic的官方文档,在google上进行了无数次搜索都没有答案,可能我要找的答案太冷门。这一切都起源于Java EE官方文档里的“cart”例子,我被他迷惑了整整一天。因为这个项目在Netbeans+GlassFish环境下可以运行的很好,直接右击项目,点运行就可以了。结果拿到Eclipse来,碰到了一堆问题,不是注入的EJB变量为Null要不就是找不到类。经过一天的摸索,现在终于有点头绪了,现在整理出来,希望可以帮助大家。而大家可能有更好的方法或者对我的叙述有疑问和意见,请大胆评论。大笑

一、应用环境

本文假设您已经有了Eclipse或Spring Source Tool和Weblogic的配置经验。本项目是用Application Client project来访问EJB模块,比直接用Java EE容器管理的Web项目要复杂,因为web client与EJB模块在同一容器,可以很方便的使用Dependency Injection(依赖注入)。而Application Client是运行在单独的Application Client Container之中,它需要与Java EE容器交互,获取容器里的资源,就需要一些额外的设置。

所用工具:Spring Source Tool(本质上还是Eclipse,通用),weblogic command tool.

源代码:Github --- Hello project

二、创建项目

 

1、新建一个Enterprise Application Project。

右击Package Explorer空白处,选择New->Other.

 

然后在Java EE下面选择Enterprise Application Client

 

点Next,填写项目基本信息,在这里我新建了一个hello项目,运行环境就选择weblogic。

 

在这个界面勾选Generate application.xml deployment descriptor,然后点击New Module来创建EJB和Client。

 

取消Web module,这里我们不创建Web Client和Connector。为Application client和EJB模块命名,之后点finish。

 

Eclipse就为我们生成了如下三个项目,helloClient-应用程序客户端,helloEJB-EJB模块,还有一个hello是负责把这两个模块打包成EAR部署到Weblogic。

 

2、编写EJB模块代码

EJB模块的代码结构如下:

 

其中hello.ejb.interfaces包下的Hello.java是一个远程业务接口,即运行在不同Java虚拟机里的client也可以访问它提供的服务,代码如下:

  1. package hello.ejb.interfaces;
  2.  
  3. import javax.ejb.Remote;
  4.  
  5. @Remote
  6. public interface Hello {
  7.  
  8. public String sayHello(String name);
  9.  
  10. }

 

HelloBean是一个stateless session bean。当然stateful也可以,毕竟就这一个Application Client,它的代码如下:
  1. package hello.ejb;
  2.  
  3. import javax.ejb.Stateless;
  4.  
  5. import hello.ejb.interfaces.Hello;
  6.  
  7. @Stateless
  8. public class HelloBean implements Hello {
  9.  
  10. @Override
  11. public String sayHello(String name) {
  12. return "Hello: " + name;
  13. }
  14.  
  15. }
一个很简单的方法,给name变量加上“Hello: ”,然后返回。

3、设置Application Client

右击helloClient,选择properties。

 

打开Deployment Aseembly菜单,选择Manifest Entries,点Add...,把helloEJB.jar添加进去,添加此包是为了编译时不出错。点Finish。

 

helloClient的结构如图:

 

先看HelloTest.java的代码(我把默认生成的Main类删除了):

  1. package com.hello.client;
  2.  
  3. import javax.ejb.EJB;
  4.  
  5. import hello.ejb.interfaces.Hello;
  6.  
  7. public class HelloTest {
  8.  
  9. @EJB
  10. private static Hello hello;
  11.  
  12. /**
  13. * @param args
  14. */
  15. public static void main(String[] args) {
  16.  
  17. System.out.println(hello.sayHello("David"));
  18.  
  19. }
  20.  
  21. }
hello变量用了@EJB注解来表示此变量使用容器依赖注入,然后在main方法中调用它的sayHello方法,并传递变量“David”。再看META-INF下的MANIFEST.MF文件,它的内容是:
  1. Manifest-Version: 1.0
  2. Class-Path: helloEJB.jar
  3. Main-Class: com.hello.client.HelloTest
Class-Path是之前在选择helloEJB项目依赖时自动添加的,Main-Class是指定包含main方法的类,这个是必须的,一会儿运行这个项目时就会知道。然后再有一个文件很重要,weblogic-application-client.xml文件,它是这样被创建的,在META-INF下新建一个文件,选择Oracle WebLogic Application Client Descriptor:



点下一步,输入名字:weblogic-application-client.xml.

它的内容是:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <wls:weblogic-application-client xmlns:wls="http://xmlns.oracle.com/weblogic/weblogic-application-client"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4. xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
  5. http://java.sun.com/xml/ns/javaee/javaee_5.xsd
  6. http://xmlns.oracle.com/weblogic/weblogic-application-client
  7. http://xmlns.oracle.com/weblogic/weblogic-application-client/1.3/weblogic-application-client.xsd">
  8.  
  9. <!-- 定义要引用的EJB模块的JNDI名字 -->
  10. <wls:ejb-reference-description>
  11. <!-- 要使用EJB的变量 -->
  12. <wls:ejb-ref-name>com.hello.client.HelloTest/hello</wls:ejb-ref-name>
  13.  
  14. <!-- JNDI命名规则:java:global/[应用程序名]EJB模块名/Bean名 -->
  15. <wls:jndi-name>java:global/hello/helloEJB/HelloBean</wls:jndi-name>
  16. </wls:ejb-reference-description>
  17.  
  18. </wls:weblogic-application-client>
这个文件是专门用来描述Application Client项目的,若要引用EJB模块,这个文件是必须的,它指定了要引用ejb模块的变量的名称和所在的类,以及

EJB模块的JNDI名称,java:global是用来查找remote业务服务接口的。可以从weblogic console里面找到应用程序名,EJB模块名和Bean名。



4、导出Application Client与EJB包

由于WebLogic的OEPE插件不能直接在Eclipse下运行Application Client,所以我们需要把它和它引用的EJB包导出来,在命令行运行。右击helloClient,

选择Export:

 

然后选择Java EE下的App Client Jar file

 

指定Jar包的名称和路径。

点Finish创建,同样的helloEJB,选择EJB下的EJB JAR file,过程与App client jar file一样,这两个jar包都要放在同一个路径下。

 

5、运行helloClient

把hello这个Enterprise Application部署到WebLogic下,helloEJB和helloClient也会自动部署:

然后先设置WebLogic的环境变量,进入WebLogic安装目录,路径如下(根据自己的安装路径):

里面有setWLSEnv.cmd文件,是用来临时设置环境变量的,在cmd中运行它:

出现Your enviroment has been set即设置成功。现在可以运行我们的helloClient了,在命令行进入你放置helloClient.jar和helloEJB.jar的文件夹,运行如下命令:

java weblogic.j2eeclient.Main helloClient.jar t3://localhost:7001,这个是weblogic的命令行工具,一般这样使就够了,最多后面还可以传递几个main方法里的参数。

出现Hello: David,调用成功。如果当时没有定义weblogic-application-client.xml的话,就会出现如下错误:

三、结束

通过这个项目,对weblogic发布Java EE项目更加熟悉了,而且也了解了怎样使用WebLogic的t3协议访问它的实例,并且使helloClient中的EJB变量hello注入成功。做这个项目之前还有几个测试项目,折腾的时间更长,还熬夜查资料,做不出来就坚决不睡觉,现在终于可以松口气休息了。大笑

posted @ 2018-07-21 14:55  有梦就能实现  阅读(1693)  评论(0编辑  收藏  举报