Bookmark and Share Share   

Getting Started with EMML and the EMML Reference Runtime Engine

The Open Mashup Alliance is an organization of leading software vendors, consulting companies, technology service providers, IT industry leaders and individuals that stewards the Enterprise Mashup Markup Language (EMML) as an open, freely available language for the development, interoperability and compatibility of enterprise mashups. EMML is an XML language that provides features to connect to many different web services or web sites and mash responses into a new result.

You can download both the EMML schema and the EMML Reference Runtime Engine that serves as a non-commerical EMML demonstration engine that processes mashup scripts written in EMML. You can also download sample mashup scripts.

System Requirements

  • 1 Gigabyte (GB) of RAM.

  • 50 Megabytes (MB) of available hard disk space for installation.

  • Windows , Linux, Mac OS X or Solaris operating system.

  • JDK 1.5 or later.

  • Any J2EE compliant application server.

    The EMML Reference Runtime Engine has been tested with Tomcat 5.5.20.

Installation

Before you install the EMML package, install the JDK (1.5 or above) and Tomcat 5.5 or another compatible application server.

  1. Download the EMML package at http://www.openmashup.org/download. See EMML Licenses for more information on licensing for this package.

  2. Expand the ZIP file you downloaded in any folder on your computer. The ZIP contains:

    • emmlclient.class: a command line utility for testing mashup scripts.

    • EMMLSpec.xsd: the EMML schema.

    • emml.war: the EMML Reference Runtime Engine web application.

    • README.html: installation and getting started instructions.

  3. Deploy emml.war in your application server.

    For Tomcat simply copy emml.war to tomcat-install/webapps.

  4. Start your application server.

    For Tomcat, run tomcat-install/bin/startup.bat or tomcat-install/bin/startup.sh.

  5. To make testing easy, copy emmlclient.class to the web-apps-home/emml/WEB-INF/classes folder. Or add emmlclient.class to the classpath in your environment.

  6. If the EMML Engine must access services through a proxy server, update EMML Engine configuration. See EMML Reference Runtime Engine Configuration for instructions.

For EMML samples:

  1. Download EMML samples from http://www.openmashup.org/download.

  2. Expand the samples ZIP file to the web-apps-home/emml/WEB-INF/classes folder.

Getting Started

Once the EMML Engine is deployed and running, you are ready to start developing mashups.

  • If desired, add the EMML schema, emml-install/EMMLSpec.xsd, to your XML editor. This allows many XML editors to provide syntax assistance and validation as you work.

  • Create a mashup script using EMML.

    See Creating a Mashup Script for instructions. Or if you have downloaded samples, see the sample mashup scripts for basic syntax and use cases.

  • Deploy the mashup script to the EMML Engine. See Deploying Mashups in the EMML Engine for instructions.

  • Test the mashup script with emmlclient.class from the command line. If you have added the client class to your classpath during installation, use the command:

    java emmlclient url-for-mashup

    See Testing Mashups from a Command Line for more information.

  • Use mashup results in other applications or provide a user interface by invoking the mashup. See Invoking Mashups at Runtime for instructions.

    Mashup results are returned in XML format.

.

EMML Licenses

Licenses for the EMML package include: