Lottery WebLogic JMS, Jersey, JMX, JNDI Óbudai Egyetem, Java Enterprise Edition Műszaki Informatika szak Labor 8 Bedők Dávid 2016.01.25. v0.3
Feladat A Lottery alkalmazás portolása WebLogic alkalmazás szerverre. Remote JMS client készítése Local JMS client készítése JMX management lehetőségek Nehézségek: bár az implementált osztályok csekély mértékben módosulnak, a környezeti beállítások eltérnek, és természetesen teljesen már library-k (implementációk) vannak használva runtime WebLogicnál (JBoss-szal összehasonlítva). 2
Architektúra (változatlan) 3
RedHat JBoss vs. Oracle WebLogic JBoss 6.4 WebLogic 12.2.1 JEE version JEE6 JEE6 Logging JBoss Logging, Log4J,.. JDK Logging,.. REST WS RESTEasy 2.3.10.Final Jersey 1.18 JPA Provider Hibernate 4.2.18.Final EclipseLink 2.5.2 JMS Provider HornetQ 2.3.25.Final WebLogic JMS JAXB JAXB 2.2.5-redhat-9 JAXB 2.2.10 Oracle 4
JMS Provider beállítása I JMS Server and JMS Module WebLogic Administration Console Services Messaging JMS Servers New name: demojmsserver persistence store: none target: myserver Services Messaging JMS Modules New name: demojmsmodule location in domain: blank target: myserver Would you like to add resources to this JMS system module? yes 5
JMS Provider beállítása II JMS Submodule és JMS Destination (queue) Services Messaging JMS Modules demojmsmodule Subdeployments New name: demojmssubmodule target/server: demojmsserver target: myserver Would you like to add resources to this JMS system module? yes Services Messaging JMS Modules demojmsmodule Configuration New type: Queue name: lotteryqueue JNDI name: jms/queue/lotteryqueue subdeployments: demojmssubmodule 6
JMS Provider beállítása III Connection Factory Services Messaging JMS Modules demojmsmodule Configuration New type: Connection Factory name: democonnectionfactory JNDI name: jms/democonnectionfactory target: myserver 7
Message Driven Bean LotteryListener.java @MessageDriven(name = "LotteryListener", activationconfig = { // @ActivationConfigProperty(propertyName = "connectionfactoryjndiname", propertyvalue = "jms/democonnectionfactory"), @ActivationConfigProperty(propertyName = "initialcontextfactory", propertyvalue = "weblogic.jndi.wlinitialcontextfactory"), @ActivationConfigProperty(propertyName = "destinationtype", propertyvalue = "javax.jms.queue"), @ActivationConfigProperty(propertyName = "destinationjndiname", propertyvalue = "jms/queue/lotteryqueue"), @ActivationConfigProperty(propertyName = "acknowledgemode", propertyvalue = "Auto-acknowledge") }) public class LotteryListener implements MessageListener, MessageDrivenBean {.. } MessageDrivenBean implementálása nem kötelező, de lehetőséget ad az MDB életciklusába való beavatkozásra (setmessagedrivencontext(..) és ejbremove() metódusok által). 8
Message Driven Bean JBoss vs. WebLogic Activation Config Property name JBoss property value WebLogic property value Megjegyzés connectionfactory JndiName jms/democonnec tionfactory Megadása külső JMS Provider esetén érdekes (pl. ActiveMQ-t). Nem kötelező. initialcontextfacto ry org.jboss.naming. remote.client. InitialContextFacto ry weblogic.jndi. WLInitialContextFact ory Nem kötelező destinationtype javax.jms.queue javax.jms.queue Másik lehetséges érték a javax.jms. Topic destinationjndina me jms/queue/lottery queue jms/queue/lotteryq ueue A destinationjndiname és destination közül csak egy egyik szükséges. destination lotteryqueue - WebLogic nem támogatja, JBoss-ban van belső rövid név, de használható a JNDI név is! acknowledgemode Auto-acknowledge Auto-acknowledge WebLogic dokumentáció szerint nem veszi figyelembe. Sok helyen írják nagybetűvel (AUTO_ACKNOWLEDGE). 9
Remote JMS Client SimpleClient.java final Properties environment = new Properties(); environment.put(context.initial_context_factory, "weblogic.jndi. WLInitialContextFactory"); environment.put(context.provider_url, "t3://localhost:7001"); environment.put(context.security_principal, "weblogic"); environment.put(context.security_credentials, "AlmafA1#"); Context context = new InitialContext(environment); final ConnectionFactory connectionfactory = (ConnectionFactory) context. lookup("jms/democonnectionfactory"); final Destination destination = (Destination) context.lookup ("jms/queue/lotteryqueue"); Connection connection = connectionfactory.createconnection("weblogic", "AlmafA1#"); final Session session = connection.createsession(false, Session. AUTO_ACKNOWLEDGE); final MessageProducer producer = session.createproducer(destination); connection.start(); final TextMessage textmessage = session.createtextmessage("1, 2, 3, 4, 5"); producer.send(textmessage); connection.close(); 10
Remote JMS Client JBoss vs. WebLogic JBoss WebLogic PROVIDER URL remote://localhost:4447 t3://localhost:7001 USERNAME jmstestuser weblogic PASSWORD User#70365 AlmafA1# DESTINATION JNDI jms/queue/lotteryqueue jms/queue/lotteryqueue INITIAL CONTEXT FACTORY org.jboss.naming.remote. client.initialcontextfactory weblogic.jndi. WLInitialContextFactory CONNECTION FACTORY JNDI jms/remoteconnectionfactory jms/democonnectionfactory CLASSPATH (Initial Context Factory osztálya) org.jboss.as:jboss-as-jmsclient-bom:7.2.0.final [WL-HOME] \wlserver\server\lib\wlthint3cl ient.jar JBoss esetén külön guest user-t hoztunk létre, míg weblogic-nál az Admin user-t használhatjuk. A Connection Factory-t JBoss esetén a standalone-full.xml-ből előre konfigurálva kaptuk, míg WebLogic esetén mi hoztuk létre Admin console-on. 11
Internal JMS Client InitialContext context = new InitialContext(); QueueConnectionFactory connectionfactory = (QueueConnectionFactory) context. lookup("javax.jms.queueconnectionfactory"); QueueConnection connection = connectionfactory.createqueueconnection(); QueueSession session = connection.createqueuesession(false, Session. AUTO_ACKNOWLEDGE); Queue queue = (Queue) context.lookup(" jms/queue/lotteryqueue"); QueueSender sender = session.createsender(queue); TextMessage textmessage = session.createtextmessage(); connection.start(); textmessage.settext(" 1, 2, 3, 4, 5"); sender.send(textmessage); SendQueueServlet.java sender.close(); session.close(); connection.close(); Üzenetet küldeni container-en belül mindig egyszerűbb, lévén InitialContext-et konfiguráció nélkül egyszerűen elkérhetjük (hiszen már inicializálva van), illetve nem csak remote connection factory-kat érünk el, hanem a szabvány által definiált JNDI néven regisztrált specifikusabbakat is (pl. a példában ilyen a QueueConnectionFactory). 12
Java Management Extensions WebLogic Hasonlóan a JBoss esetén már bemutatott példához, JMX segítségével szeretnénk beállítani az aktuális sorsoló személy nevét, a nyereményalapot és a nyeremény eloszlását meghatározó szabály-vektort. A lényeg természetesen a példa szempontjából a monitorozás és a beavatkozás bemutatása. 13
Managed Bean készítése kezdő lépések LotteryMonitor.java public class LotteryMonitor extends StandardMBean implements LotteryMonitorMBean, MBeanRegistration { public LotteryMonitor() { super(lotterymonitormbean. class, false); } Fontos! Az ős (StandardMBean ) ctor-a az MBean interface osztályát várja! Az üzleti igények, és ezáltal a LotteryMonitorMBean interface megegyezik a JBossos példában bemutatottal. @Override public ObjectName preregister(mbeanserver server, ObjectName name) throws Exception { return name; } } @Override public void postregister(boolean registrationdone) {} @Override public void prederegister() throws Exception {} @Override public void postderegister() {} A MBeanRegistration interface használata lehetővé teszi az életciklusba való beavatkozást. 14
MBean regisztrációja JBoss esetén az MBean-t az EJB module jbossservice.xml leíró segítségével regisztráltuk. WebLogic esetén programozottan kell a regisztrációt elvégezni, és e programozott részt szükséges az EAR weblogic-application. xml leíró segítségével láthatóvá tenni. 15
Managed Bean regisztrációja programozott megoldás ApplicationMBeanLifeCycleListener.java package hu.qwaevisz.lottery.ejbservice.management; public class ApplicationMBeanLifeCycleListener extends ApplicationLifecycleListener { private static final String MBEAN_SERVER_JNDI = "java:comp/jmx/runtime"; private static final String OBJECT_PACKAGE = "hu.qwaevisz.lottery.ejbservice. management"; @Override public void poststart(applicationlifecycleevent e) throws ApplicationException { InitialContext context = new InitialContext(); MBeanServer mbeanserver = MBeanServer. class.cast( context.lookup (MBEAN_SERVER_JNDI) ); LotteryMonitor mbean = new LotteryMonitor(); JBoss esetén az ObjectName a ObjectName oname = this.buildobjectname(); jboss-service.xml-ben volt definiálva. mbeanserver.registermbean(mbean, oname); } private ObjectName buildobjectname() throws MalformedObjectNameException { return new ObjectName(OBJECT_PACKAGE + ":type="+lotterymonitor. class. getsimplename()+",name="+lotterymonitor. class.getsimplename()); } Az ApplicationLifecycleListener osztály miatt a[wl-home] \wlserver\server\lib\wls-api.jar-t el kell helyezni a ClassPath-on! @Override public void prestop(applicationlifecycleevent e) throws ApplicationException {} } 16
Listener leírója weblogic-application.xml weblogic-application.xml <?xml version="1.0" encoding="utf-8"?> <weblogic-application xmlns="http://xmlns.oracle. com/weblogic/weblogic-application"> <listener> <listener-class>hu.qwaevisz.lottery.ejbservice.management. ApplicationMBeanLifeCycleListener</listener-class> </listener> </weblogic-application> A weblogic-application.xml az EAR application.xml-jének conatiner specifikus párja. Ennek megfelelően az EAR META-INF könyvtárába kell elhelyezni. Ennek legegyszerűbb módja, ha a root Gradle project (EAR plugin) src/main/application könyvtárában elhelyezzük! 17
jconsole Hasonlóan a JBoss-hoz, a WebLogic esetén is szükséges a jconsole classpath-ához container specifikus JAR-ok hozzáadása. > jconsole -J-Djava.class.path=%JAVA_HOME%\lib\jconsole.jar;%JAVA_HOME% \lib\tools.jar;%mw_home%\wlserver\server\lib\wljmxclient.jar;%mw_home% \wlserver\server\lib\wlclient.jar -J-Djmx.remote.protocol.provider. pkgs=weblogic.management.remote -debug A ClassPath beállításának egyszerű módja, ha lefuttatjuk a setdomainenv.[sh cmd] parancsot, majd ezt követően (azonos terminalban/command ablakban) a jconsole-t elindítjuk. > [WL-HOME]/user_projects/domains/mydomain/bin/setDomainEnv.[sh cmd] > jconsole 18
EJB elérése MBean osztályból JBoss esetén ennek semmilyen akadálya nincsen, egyszerűen az @EJB annotáció segítségével inject-áljuk a megfelelő EJB-t, és már használhatjuk is. Az MBean azonosan EJB managed elem lesz (csak managed elemek esetén használható az injectálás ). Ott, ahol ez nem érhető el, JNDI fából kell kikérnünk az EJB-t, hasonlóan mint ahogy egy remote EJB kliensből tennénk, azonban természetesen az Initial Context-et a helyi container már inicializálta számunkra. WebLogic esetén ez utóbbit alkalmazzuk, az @EJB annotáció ott nem működik egy MBean esetén. 19
Managed Bean regisztrációja programozott megoldás LotteryMonitor.java public class LotteryMonitor extends StandardMBean implements LotteryMonitorMBean, MBeanRegistration { private static final String LOTTERY_STATE_HOLDER_JNDI = " java:global.lottery- 1.0.lot-ejbservice.lotteryState"; Honnan tudjuk hogy a private LotteryStateHolder getstateholder() { LotteryStateHolder Singleton LotteryStateHolder holder = null; EJB-nek mi a pontos JNDI neve? try { InitialContext context = new InitialContext(); holder = LotteryStateHolder. class.cast( context.lookup (LOTTERY_STATE_HOLDER_JNDI) ); } catch (NamingException e) { LOGGER.log(Level.SEVERE, e.getmessage(), e); } return holder; } @Override public String getpuller() { LotteryStateHolder holder = this.getstateholder() return holder!= null? holder.getcurrentpuller() : ""; } } 20
WebLogic JNDI Tree WebLogic Administration Console Environment Server Configuration General tab VIEW JNDI Tree link! Deploy-olt alkalmazások EJB-inek elérése (a JNDI fa felépítése container specifikus, bár a JEE szabvány megpróbálta már szabványosítani): java:global lottery-1.0 (deployolt EAR neve (a pont miatt a browser ketté szedi)) lot-ejbservice (az EJB module neve az EAR-on belül) lotterystate (az EJB name attribútuma (def: impl. osztály neve)) Overview tab Binding Name tulajdonság értéke @Singleton(mappedName = "ejb/lotterystate", name = "lotterystate") public class LotteryStateHolderImpl implements LotteryStateHolder {} 21
Java Management Extensions JBoss vs. WebLogic MBean interface MBean implementáció MBean regisztráció jconsole futtatása JBoss Java interface az MBean készítés szabályai szerint*. EJB managed EJB module META-INF-jében elhelyezett jboss-service.xml segíségével. [JBOSS HOME]/bin/jconsole. [bat sh] WebLogic Java interface az MBean készítés szabályai szerint*. Not EJB managed (JNDI lookup szükséges) EAR csomag META-INF-jében elhelyezett weblogic-application.xml segítségével egy leszármaztatott ApplicationLifecycleListener regisztrációja. [WL-HOME] /user_projects/domains/mydomain/bin/set DomainEnv.[sh cmd] jconsole *: https://docs.oracle.com/javase/tutorial/jmx/mbeans/standard.html 22