ibeans dead simple integration

All contents Copyright © 2009, MuleSoft Inc.

iBeansdead-simple integration

for the web


about me

• Creator of the Mule ESB Project 2003

• Founder, MuleSoft

• Creator of iBeans

• 15 years of hooking s#!t together

• Lazy


agenda

• Introduction to iBeans

• The API

• Code dive

• Demo

• The future of iBeans


overview


goals

• Integration for the Web

• No SOA

• Minimal concepts, no TLAs

• Reuse

• Task-focused

• Cross-platform; Java, JS, Scala, JRuby


application annotations

• Receive and send data

• Schedule tasks

• Create request / response services

• HTTP, JMS, DB, FTP, etc

• Use on your application objects

– POJOs, Spring beans, Struts actions, etc


ibean objects• iBeans are simple objects that talk to stuff


what is an ibean?

• A well-defined interface to a service

– ‘service’ - public or internal

• HTTP, JMS, FTP, JDBC, etc.

• Developers can use public iBeans

• Developers can create their own easily


Application Annotations


annotations: schedule

public class MyObject { @Schedule(interval=“60000”) String shoutOut() { return “Hey what’s up?”;

}

}

}


annotations: schedule with cron

public class MyObject { @Schedule(cron=“0 * * * * ?”) String shoutOut() { return “Hey what’s up?”;

}

}

}


public class MyObject { @Schedule(cron=“0 * * * * ?”) @Send(uri=“xmpp://${jabber.creds}@jabber.org:6666/myGroup?

groupChat=true”)

String shoutOut() { return “Hey what’s up?”;

}

}

annotations: scheduled send


annotations: receive

public class MyObject { @Receive(uri=“jms://my.queue”) void onMessage(Object msg) { log(msg);

}

}

}


annotations: polling receive

public class MyObject { @Schedule(cron=“0 0 12 * * ?”)

@Receive(uri=“jms://my.queue”) void onMessage(Object msg) { log(msg);

}

}

}


Architecture


architectureRuntime Container: Tomcat, Tcat, (Mule)Runtime Container: Tomcat, Tcat, (Mule)

iBeansiBeans

Channels: HTTP, SMTP, IMAP, REST, JDBC, JMS, XMPP, FTP


Transform and BindingsScheduler

Web appsWeb apps

appswebyourconsole

iBean Objects

Formats: JSON, RSS, ATOM, XML, SOAP


ibeans centralRuntime Container: Tomcat, Tcat, (Mule)Runtime Container: Tomcat, Tcat, (Mule)

iBeansiBeans

Channels: HTTP, SMTP, IMAP, WS, REST, JDBC, JMS, XMPP,

FTP, ATOM


Transforms and bindings

Scheduler

Web appsWeb apps

appswebyourconsole

iBeans Centralrepository

iBean Objects


iBean Objects


what is an ibean?

• Encapsulates a service in a way that users don’t need to read the manual

• Use in Java, Groovy and JavaScript

– more languages to follow

• Re-usable, publish to iBeans Central

– Or a private repository


using an ibean in java

public class MyObject{ @IntegrationBean

private TwitterIBean twitter; public void logTimeline() { twitter.setCredentials(“user”, “shhhh”); log(twitter.getFriendTimeline()); }}


using an ibean in javascript

<script type="text/javascript”> var ibeans = new IBeansClient(); creds = ibeans.config.get(“twitter.user”, “twitter.pass”); ibeans.twitter.setCredentials(creds[0], creds[1]); ibeans.twitter.getFriendTimeline(readTweets); function readTweets(tweets, error) { //do stuff }</script>


create an ibean

• A Java interface with annotated methods

• A definition of how to talk to a service

– Not the code to actually do it


create an ibean

public interface MyTwitterIBean{ @Call(uri="http://twitter.com/statuses/show/{id}.json") String statusesShow(@UriParam("id") String id)

throws CallException;

}


an ibean can have state

public interface MyTwitterIBean{ @State void init(@UriParam(“format”) String format);

@Call(uri="http://twitter.com/statuses/show/{id}.{format}") String statusesShow(@UriParam("id") String id) throws …;}


an ibean can have defaultspublic interface MyTwitterIBean{ @UriParam(“format”) static String DEFAULT_FORMAT = “json”;

@State void init(@UriParam(“format”) String format);

@Call(uri="http://twitter.com/statuses/show/{id}.{format}") String statusesShow(@UriParam("id") String id) throws …;}


Transforms & Bindings


transforms

• Transformers convert one object to another

– String to a URL

– Transform XML; Xquery, XSLT

– Enrich data


transforms

• Transformers are discovered not configured– Based on the current object received and the object type

required by a method parameter.

• Annotations for injecting meta data– Message headers*

– Attachments*

* not shown today


transforms

public class SimpleTransformers { @Transformer URL toUrl(String string) throws MalformedURLException {

return new URL(string);

}

}


bindings

• Marshal and Unmarshal Objects

– XML (JAXB)

• XML document to an Order object

– JSON (Jackson)

• JSON String to a TwitterUser object

• Supports automatic handling


bindings: jaxb

public class JaxbTransformers { @Transformer Order toOrder(Document doc, JAXBContext jaxb) throws … {

Unmarshaller u = jaxb.createUnmarshaller();

return (Order) u.unmarshal(selectOne(“/env/order”, doc);

}

}


bindings: jaxb

public class MyObject { @Receive(uri=“jms://my.queue”) void onMessage(@MessagePayload Order order) { log(order);

}

} Tells iBeans to transform the JMSPayload to an Order object


…but wait

• How do we go from a Jms Message to an Xml Document?

• Jms Message is normalized

– TextMessage – String

– BytesMessage – byte[ ]

– ObjectMessage – Deserialized Object

– etc


…and we need to add…

public class JaxbTransformers { @Transformer(sourceTypes={String.class}) Order toOrder(Document doc, JAXBContext jaxb) throws … {

Unmarshaller u = jaxb.createUnmarshaller();

return (Order) u.unmarshal(selectOne(“/env/order”, doc);

}

}


transform flow


an ibean can use transformerspublic interface MyTwitterIBean{ … @State void init(@UriParam(“format”) String format, @ReturnType Class retType);

@Call(uri="http://twitter.com/statuses/show/{id}.{format}")

<T> T statusesShow(@UriParam("id") String id) throws …;}


coding with ibeans

• Eclipse IDE plugin

• Maven Archetypes, Run targets

• Template projects

• No Support for IntelliJ yet…


Framework Support


spring

<beans …> <bean name="ibeansContext” class="org.mule.ibeans.spring. IBeansContextFactoryBean"/> …</beans>


guice

public class MyModule extends AbstractGuiceIBeansModule{ protected void doConfigure() throws Exception { bind(EchoService.class).asEagerSingleton(); }}


coming soon

• GWT / GXT• Grails• Play Framework• JSF• Struts 2 (may already work)


other things

• Support for JavaScript and AJAX

• iBeans has a Groovy shell

– Execute scripts interactively or command-line

• iBeans Console

– Configure your iBeans instance

– Browse and Download from iBeans Central


possibilities

• Great for runtime containers

– Cloud containers (App Engine)

– Wikis: Confluence, Xwiki

• DSLs (Scala?)

• Mobile applications (JavaScript)

• Widgets (Google Gadgets / Wave)


whats next for ibeans

• Web Services support (JAX-RS/WS)

• Support for scripting in the console

• Centralized configuration

• Mule 3.0 will be able to host iBeans

• Better JavaScript support


…and after that

• Support for other languages: Scala, Ruby, Clojure, etc

• Become the WCF for the JVM?


thanks

• web: http://mulesoft.org/ibeans

• blog: http://blog.rossmason.com

• twitter: @rossmason

ibeans dead simple integration

Technology

uriparam format string

creds1 ibeans

pass ibeans

future of ibeans

jaxb public classmyobject

schedule public classmyobject

uriparam id string idthrows

java public classmyobject