niedziela, 31 sierpnia 2008

Mule "echo" przykład

Po długim okresie nie pisanie czas wrócić do ESB w szczególności Mule 2.0, od czasu mojego ostatniego wpisu na temat instalacji Mule, na stronie projektu ukazała się ogromna ilość dokumentacji :) www.mulesource.org . Więc startujemy tworzymy nowy Mule 2.0 projekt:

Klikamy "Finish" i już mamy projekt stworzony:) Więc tak pierwsze zadanie to stworzyć klasę która będzie sprawdzała czy przekazana wartość z standardowego wejścia to "lukasz" jeśli tak to wypisze przywitanie w innym wypadku rzuci wyjątek.
Więc postępując zgodnie z dobrymi praktykami programistycznymi stworzymy interfejs:
package com.itsilesia;

/**
* @author lipka
*
*/
public interface Echo {
String echoMessage(String echo);
}

teraz implementujemy nasz interfejs:
package com.itsilesia;

/**
* @author lipka
*
*/
public class EchoUMOComponent implements Echo {

public String echoMessage(String echo) {
if(echo.equals("lukasz")){
return "Witaj "+echo;
}else{
throw new IllegalArgumentException("Zle dane");
}
}

}

skoro już mamy klasę, zostało nam tylko teraz napisać odpowiedni plik konfiguracyjny który przeczyta coś ze standardowego wyjścia prześle do naszego komponentu EchoUMOComponent a w razie nie powodzenia będzie w stanie obsłużyć wyjątek (w naszym wypadku wypisać na konsole).
<?xml version="1.0" encoding="UTF-8"?>
<mule xmlns="http://www.mulesource.org/schema/mule/core/2.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:spring="http://www.springframework.org/schema/beans"
xmlns:stdio="http://www.mulesource.org/schema/mule/stdio/2.0"
xmlns:vm="http://www.mulesource.org/schema/mule/vm/2.0"
xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
http://www.mulesource.org/schema/mule/core/2.0 http://www.mulesource.org/schema/mule/core/2.0/mule.xsd
http://www.mulesource.org/schema/mule/stdio/2.0 http://www.mulesource.org/schema/mule/stdio/2.0/mule-stdio.xsd
http://www.mulesource.org/schema/mule/vm/2.0 http://www.mulesource.org/schema/mule/vm/2.0/mule-vm.xsd">
<description>Very simple echo example.</description>
<stdio:connector name="SystemStreamConnector"
promptMessage="Wpisz czarodziejskie slowo: " messageDelayTime="1000" />
<model name="echo">
<service name="displayingMessage">
<inbound>
<stdio:inbound-endpoint system="IN" />
</inbound>
<component class="com.itsilesia.EchoUMOComponent" />
<outbound>
<outbound-pass-through-router>
<stdio:outbound-endpoint system="OUT" />
</outbound-pass-through-router>
</outbound>
<default-service-exception-strategy>
<stdio:outbound-endpoint system="OUT" />
</default-service-exception-strategy>
</service>
</model>
</mule>

Krótki opis tego tagów z pliku myecho-config.xml:
  • xsi:schemaLocation="http://www.springframework.org/schema/.. -importujemy niezbędną przestrzeń nazw do dalszej konfiguracji Mule
  • stdio:connector - definiujemy konektor który czyta z standardowego wejścia czyli konsoli i do tego wypisuje nam komunikat zachęcający do wpisanie czegoś
  • model nazwa przez nas stworzonego modelu przetwarzania informacji
  • service name="displayingMessage" tworzenie naszego serwisu
  • inbound określenie danych wejściowych, na które ma reagować nasz model, w naszym przypadku reaguje on na wpisanie wyrazu i wciśnięcie klawisza ENTER
  • component class="com.itsilesia.EchoUMOComponent" po przejściu przez inbound informacja jest przekazywana do naszego komponentu, gdzie następuje przetwarzanie odebranej informacji
  • outbound i outbound-pass-through-router wyłapują informacje po przejściu przez nasz komponent i w naszym wypadku wypisują przetworzoną informacje na standardowe wyście
  • default-service-exception-strategy ten element wyłapuje wyjątki lecące w aplikacji i wypisuje je na standardowe wyjście
Więc wszytko gotowe teraz tylko uruchomić:

********************************************************************************
* A Fatal error has occurred while the server was running: *
* com.itsilesia.EchoUMOComponent (java.lang.ClassNotFoundException) *
* *
* The error is fatal, the system must shutdown *
* Server started: 01.01.70 01:00 *
* Server shutdown: 31.08.08 14:27 *
********************************************************************************

niestety Mule nie mogło znaleźć naszej klasy, musimy ja tam skopiować, najszybciej po prostu zrobić jara za pomocą Eclipse export i potem skopiować go do katalogu gdzie zainstalowaliśmy Mule a dokładni do katalogu lib/user/

Uruchamiamy nasz przykład:
lukasz-lipkas-computer:~/Documents/workspace/MyEcho lipka$ mule -config conf/myecho-config.xml

Wpisz czarodziejskie slowo:
lukasz

INFO 2008-08-31 15:09:23,509 [SystemStreamConnector.dispatcher.1] org.mule.transport.stdio.StdioMessageDispatcher: Connected: StdioMessageDispatcher{this=7d08eb, endpoint=stdio://system.out, disposed=false}
Witaj lukasz

Wpisz czarodziejskie slowo:
lipka
ERROR 2008-08-31 15:09:26,291 [displayingMessage.3] org.mule.service.DefaultServiceExceptionStrategy:
********************************************************************************
Message : Component that caused exception is: displayingMessage. Message payload is of type: String
Type : org.mule.api.service.ServiceException
Code : MULE_ERROR--2
JavaDoc : http://mule.mulesource.org/docs/apidocs/org/mule/api/service/ServiceException.html
Payload : lipka
********************************************************************************
Exception stack is:
1. Zle dane (java.lang.IllegalArgumentException)
com.itsilesia.EchoUMOComponent:16 (http://java.sun.com/j2se/1.5.0/docs/api/java/lang/IllegalArgumentException.html)
2. Component that caused exception is: displayingMessage. Message payload is of type: String (org.mule.api.service.ServiceException)
org.mule.component.DefaultLifecycleAdapter:214 (http://mule.mulesource.org/docs/apidocs/org/mule/api/service/ServiceException.html)
********************************************************************************
Root Exception stack trace:
java.lang.IllegalArgumentException: Zle dane
at com.itsilesia.EchoUMOComponent.echoMessage(EchoUMOComponent.java:16)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:585)
at org.mule.model.resolvers.AbstractEntryPointResolver.invokeMethod(AbstractEntryPointResolver.java:147)
at org.mule.model.resolvers.ReflectionEntryPointResolver.invoke(ReflectionEntryPointResolver.java:127)
at org.mule.model.resolvers.DefaultEntryPointResolverSet.invoke(DefaultEntryPointResolverSet.java:50)
at org.mule.component.DefaultLifecycleAdapter.intercept(DefaultLifecycleAdapter.java:202)
at org.mule.component.AbstractJavaComponent.invokeComponentInstance(AbstractJavaComponent.java:82)
at org.mule.component.AbstractJavaComponent.doOnCall(AbstractJavaComponent.java:73)
at org.mule.component.AbstractComponent.onCall(AbstractComponent.java:87)
at org.mule.model.seda.SedaService$ComponentStageWorker.run(SedaService.java:533)
at org.mule.work.WorkerContext.run(WorkerContext.java:310)
at edu.emory.mathcs.backport.java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1061)
at edu.emory.mathcs.backport.java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:575)
at java.lang.Thread.run(Thread.java:613)

********************************************************************************

ERROR 2008-08-31 15:09:26,292 [displayingMessage.3] org.mule.service.DefaultServiceExceptionStrategy: Message being processed is: org.mule.transport.DefaultMessageAdapter/org.mule.transport.DefaultMessageAdapter@2ed6f9{id=099b0bf3-775e-11dd-a41e-b944827db778, payload=java.lang.String, correlationId=null, correlationGroup=-1, correlationSeq=-1, encoding=UTF-8, exceptionPayload=org.mule.message.DefaultExceptionPayload@237817}
ExceptionMessage{message=lipka, context={MULE_ORIGINATING_ENDPOINT=endpoint.stdio.system.in}exception=org.mule.api.service.ServiceException: Component that caused exception is: displayingMessage. Message payload is of type: String, componentName='displayingMessage', endpointUri=stdio://system.in, timeStamp=Sun Aug 31 15:09:26 CEST 2008}

Wszystko działa więc teraz trzeba będzie to trochę skomplikować i w następnym wpisie połączyć to z jakimś serwerem ftp i jms.

środa, 28 maja 2008

Świetna Javowa konferencja JAVArsovia II

31 maja w Warszawie dobędzie się największa polska konferencja o tematyce Javy. Warto wspomnieć, że konferencja jest za darmo. Więc warto się zarejestrować i kto może to w sobotę do Warszawy. A ci co nie dają rady się tam pojawić mogą tylko liczyć na to, że organizatorzy udostępnią materiały:)

środa, 7 maja 2008

Ciekawa konferencja

Osoby zainteresowane takimi programami jak Scribus, Krita, Inkscape, Gimp, Blender oraz grafiką szeroko pojętą, mogą się udać do Wrocławia na darmową konferencję, więcej informacji na stronie organizatorów Libre Graphics Meeting 2008
Może ktoś z okolic Rybnika się tam wybiera?

piątek, 25 kwietnia 2008

Organizacja repozytorium

Dzisiejszym zadaniem jest zorganizowanie struktury repozytorium pod główny projekt w repozytorium subversion. Podstawowe informacje jak uruchomić svn można przeczytać w wpisie Mariusza Lipińskiego. Dobra a teraz do dzieła tworzymy trzy główne katalogi:
- trunk
- branches
- tags
W trunk trzymamy główną część projektu (najbardziej rozwojowa gałąź), branches przeznaczamy na poprawianie błędów i na eksperymentowanie developerów, jako ostatni został nam katalog tags gdzie zamrażamy konkretne wydania naszego projektu, jakieś ważne wydarzenie z cyklu życia naszego projektu (z reguły koresponduje on do konkretnego podkatalogu branches). Dobrze jest zrobić katalog tags jak katalog tylko do odczytu. Hmm chyba wszystko na początek jakieś uwagi?

poniedziałek, 7 kwietnia 2008

Eclipse Mule IDE

Dodajemy teraz możliwość tworzenia Mule projektów w Eclipse postępujemy z godnie z instrukcja Mule IDE 2.0 Pre-release User Guide Instalujemy niezbędne komponenty do Eclipse 3.3
No i na koniec sama wtyczka z Mule IDE. Dodajemy nowe URL do Software Updates http://dist.muleforge.org/mule-ide/updates-2.0.0/ . Restartujemy Eclipse i tworzymy nowy Mule Project.
Potem musimy jeszcze skonfigurować domyślne ustawienia dla Mule.
Teraz jeszcze tworzymy plik konfiguracyjny za pomocą IDE
Nasz Eclipse IDE zostało przystosowane do pracy z Mule:) W następnym wpisie stworzymy najprostszy działający projekt z użyciem Mule, FTP i mavena.

Apache ActiveMQ instalacja

Instalacja ApacheMQ tak zwanego Message Broker sprowadza się do ściągnięcia źródeł i ich rozpakowania, korzystamy z ActiveMQ 5.0.0 Release. Uruchomianie samego serwisu bez jakiej kol wiek konfiguracji z naszej strony, sprowadza się do przejścia do rozpakowanego katalogu, później podkatalog bin i uruchomienie skryptu uruchamiającego.
lukasz-lipkas-computer:~/Library/apache-activemq-5.0.0/bin lipka$ ./activemq
Na kosoli po chwili można zobaczyć następujące logi:
Loading message broker from: xbean:activemq.xml
INFO BrokerService - Using Persistence Adapter: AMQPersistenceAdapter(/Users/lipka/Library/apache-activemq-5.0.0/data/localhost)
INFO BrokerService - ActiveMQ 5.0.0 JMS Message Broker (localhost) is starting
INFO BrokerService - For help or more information please see: http://activemq.apache.org/
INFO AMQPersistenceAdapter - AMQStore starting using directory: /Users/lipka/Library/apache-activemq-5.0.0/data/localhost
INFO KahaStore - Kaha Store using data directory /Users/lipka/Library/apache-activemq-5.0.0/data/localhost/kr-store/state
INFO ManagementContext - JMX consoles can connect to service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi
INFO AMQPersistenceAdapter - Active data files: []
INFO KahaStore - Kaha Store using data directory /Users/lipka/Library/apache-activemq-5.0.0/data/localhost/kr-store/data
INFO TransportServerThreadSupport - Listening for connections at: tcp://lukasz-lipkas-computer.local:61616
INFO TransportConnector - Connector openwire Started
INFO TransportServerThreadSupport - Listening for connections at: ssl://lukasz-lipkas-computer.local:61617
INFO TransportConnector - Connector ssl Started
INFO TransportServerThreadSupport - Listening for connections at: stomp://lukasz-lipkas-computer.local:61613
INFO TransportConnector - Connector stomp Started
INFO TransportServerThreadSupport - Listening for connections at: xmpp://lukasz-lipkas-computer.local:61222
INFO TransportConnector - Connector xmpp Started
INFO NetworkConnector - Network Connector org.apache.activemq.transport.discovery.multicast.MulticastDiscoveryAgent@28bdf4 Started
INFO BrokerService - ActiveMQ JMS Message Broker (localhost, ID:lukasz-lipkas-computer.local-50886-1207581085279-0:0) started
INFO TransportConnector - Connector vm://localhost Started
INFO log - Logging to org.slf4j.impl.JCLLoggerAdapter(org.mortbay.log) via org.mortbay.log.Slf4jLog
INFO log - jetty-6.1.4
INFO WebConsoleStarter - ActiveMQ WebConsole initialized.
INFO /admin - Initializing Spring FrameworkServlet 'dispatcher'
INFO log - ActiveMQ Console at http://0.0.0.0:8161/admin
INFO log - ActiveMQ Web Demos at http://0.0.0.0:8161/demo
INFO log - Started SelectChannelConnector@0.0.0.0:8161

Żeby sprawdzić czy działa otwieramy przeglądarkę i sprawdzamy adres http://0.0.0.0:8161/admin
Ostatni test czy wszystko działa poprawnie uruchamiamy przykład dostarczony przez dystrybutora (typowy przykład klient (czeka na 10 wiadomość) producent (produkuje 10 wiadomości)). Do uruchomienia przykładu musimy mieć zainstalowanego Anta. W katalogu gdzie rozpakowaliśmy źródła przechodzimy do pod katalogu examples i w jednej konsoli uruchamiamy klienta w drugiej producenta.
Klient:
lukasz-lipkas-computer:~/Library/apache-activemq-5.0.0/example lipka$ ant consumer
Producent:
lukasz-lipkas-computer:~/Library/apache-activemq-5.0.0/example lipka$ ant producer

Wszystko działa:) Teraz już tylko połączyć to z Mule:)


Mule instalacja

Dzisiaj czas zacząć przygodę z jednym z najbardziej popularnych, darmowych ESB MULE. Nie będę robił wprowadzenia do ESB, napiszę w skrócie do czego może się przydać.
Moja definicja ESB to:
- szyna umożliwiająca komunikacje pomiędzy różnymi serwisami, jej główne założenie to uproszczenie tworzenia architektury SOA(Service Oriented Architecture) (architektura zorientowana na usługi).
Dobra zobaczymy jak to działa w praktyce, pojawiła się nowa wersja Mule 2.o.o idziemy do Download ściągamy źródła i je rozpakowujemy. Zerkamy jeszcze co nowego w wersji 2.0.0 z ciekawych rzeczy widzę, że w następnych wersjach ma być wsparcie dla OSGi.
The Registry architecture will continue to evolve a bit in future releases and will form the basis of OSGi support in Mule.
Wracając do Mule przed rozpoczęciem całej zabawy należy zainstalować niezbędne oprogramowanie(jvm, maven, ...). Po ściągnięciu i rozpakowaniu , czytamy INSTALL.txt, i wykonujemy następujące polecenia (w zależności od systemu operacyjnego, u mnie mac):
export MULE_HOME=/Users/lipka/Library/mule-2.0.0
export PATH=$PATH:$MULE_HOME/bin
Potem w konsoli piszemy:
mule
podczas pierwszego uruchomienia musimy zaakceptować licencje.
Do you accept the terms and conditions of this license agreement [y/n]?
y
i potem widzimy (maven ściągą niezbędne jary) i na końcu:
Starting the Mule Server...
Wrapper (Version 3.2.3) http://wrapper.tanukisoftware.org
Copyright 1999-2006 Tanuki Software, Inc. All Rights Reserved.

WARN 2008-04-07 13:57:39,559 [WrapperListener_start_runner] org.mule.MuleServer: A configuration file was not set, using default: mule-config.xml


*******************************************************************************
No config file specified and no config by the name of mule-config.xml
found on the classpath.

Usage: mule -config [-builder ] [-debug] [-version]

mule-configuration - a URL for the Mule Config XML to use,
if not specified the config will be loaded from
the classpath

config-builder - a fully qualified class name of the builder to use
to configure Mule.

debug - configure Mule for JPDA remote debugging.
Customize settings by editing a JPDA_OPTS variable
in the mule startup script

version - print full product information
*******************************************************************************


INFO 2008-04-07 13:57:39,594 [Thread-0] org.mule.MuleServer: Mule server shutting down due to normal shutdown request
INFO 2008-04-07 13:57:39,603 [Thread-0] org.mule.MuleServer:
**************************************************************************************
* The server is shutting down due to normal shutdown request *
* Server shutdown: 07.04.08 13:57 *
**************************************************************************************
<-- Wrapper Stopped


Teraz jak już wszystko działa, można uruchomić najprostszy przykład, dostarczony z dystrybucją, w naszym wypadku to będzie Echo Example.
lukasz-lipkas-computer:~/Library/mule-2.0.0 lipka$ cd examples/echo/
lukasz-lipkas-computer:~/Library/mule-2.0.0/examples/echo lipka$ mule -config conf/echo-config.xml
Na konsoli powinna się pokazać możliwość wpisania jakiegoś przykładowego teksty (potem ENTER) i jeszcze raz go wyświetlenie, takie systemowe echo tylko za pomocą UMOComponentu:
**********************************************************************
* Mule ESB and Integration Platform *
* Version: 2.0.0 Build: 11521 *
* MuleSource, Inc. *
* For more information go to http://mule.mulesource.org *
* *
* Server started: 01.01.70 01:00 *
* Server ID: 8e67013c-049b-11dd-b60e-f34003987973 *
* JDK: 1.5.0_13 (mixed mode) *
* OS: Mac OS X (10.4.11, i386) *
* Host: lukasz-lipkas-computer.local (192.168.123.3) *
* *
* Agents Running: None *
**********************************************************************

Please enter something:
helloWorld :)
INFO 2008-04-07 14:10:17,896 [EchoUMO.2] org.mule.component.simple.LogComponent:
********************************************************************************
* Message received in service: EchoUMO. Content is: 'helloWorld :)' *
********************************************************************************
INFO 2008-04-07 14:10:17,911 [SystemStreamConnector.dispatcher.1] org.mule.transport.stdio.StdioMessageDispatcher: Connected: StdioMessageDispatcher{this=185633, endpoint=stdio://system.out, disposed=false}
helloWorld :)

Please enter something:


Mule już działa więc teraz trzeba będzie się przyjrzeć jak można go zastosować w projektach informatycznych.
PS. dla tych co mają maci, krótkie wprowadzenie do shella pod mac OS.