• Oracle Berkeley DB Java Edition 4.0.71 – Database met een Java API
• Sun Java DB (Apache Derby) 10.5.3.0_1 – SQL database
• DB4O 7.13 – Object database
• Apache Lucene 2.9.0 – Search index
• Neo4J 1.0-rc – Graph database
• HashMap – Java Collection

Lucene en HashMap zijn eigenlijk geen embedded databases, maar je kunt ze wel gebruiken om gegevens in op te slaan. In elk van de databases heb ik het volgende Java object opgeslagen:

public class Book {
	List authors;
	String isbn;
	String title;
	String publisher;
	String description;
	String edition;
	Date publicationDate;
	String ean;
	int numberOfPages;
	String imageUrl;
	String year;

	//Getters and Setters ..
}

De code voor het opslaan, lezen, wijzigen en verwijderen is gebaseerd op de voorbeeld code die ik van de websites van de verschillende producten te vinden is. Elke implementatie heeft de volgende interface:

public interface BookDAO {
    public abstract boolean create(Book book);
    public abstract boolean update(Book book);
    public abstract boolean delete(Book book);
    public abstract Book findByISBN(String isbn);
}

De performance testen werden uitgevoerd met behulp van JMeter JavaSampler die vanuit een maven project wordt aangeroepen met behulp van de Maven JMeter plugin (deze heb ik zelf nog moeten wijzigen om rekening te houden met classpath dependencies). Mijn test set bestaat uit 1137 records. Deze werden eerst opgeslagen, vervolgens gelezen, aangepast en tenslotte verwijderd. Onderstaande tabel toont de gemiddelde tijd om een actie uit te voeren.

Uit de resultaten kun je concluderen dat zowel Lucene als Berkeley DB heel snel zijn.

Het antwoord op deze vragen krijg je door het ontwikkelproces op de juiste manier te structureren. Dus niet zomaar iets gaan bouwen en hopen dat het voorziet in een behoefte. Nee, een zorgvuldige analyse is vereist. Het doel moet altijd zijn: hoe kun je een product (service) ontwikkelen met maximale meerwaarde voor de organisatie. Naar mijn mening moet je niet te veel kijken naar de toekomst. Wat je ontwikkelt moet nu meerwaarde bieden. Niemand kan de toekomst voorspellen. Je zou dus niet te veel tijd moeten besteden aan functionaliteit die niet direct gebruikt gaat worden. Dit is duur en eigenlijk verloren tijd.

Vantevoren moet je begrijpen wie de doelgroep is en wat deze doelgroep nodig heeft. Dit is eigenlijk precies hetzelfde als het ontwerpen van (industriële) producten. Ook hiervoor maak je een grondige analyse van bedrijfsdoelstellingen, bedrijfsprocessen, doelgroepen en analyse van concurrerende producten. Marktonderzoek kan hiervoor heel nuttig zijn. In het geval van SOA werk je meestal binnen een organisatie. Dit maakt marktonderzoek een stuk eenvoudiger. Je hoeft namelijk niet meer anoniem te werken en kunt rechtstreeks naar mensen toe stappen.

In plaats van de bestaande code aan te passen besloot ik om deze weg te gooien en opnieuw te beginnen. Dit maal besloot ik om alles in een Maven artifact te stoppen. Dit biedt als voordeel dat elke IDE mits geïntegreerd met Maven deze library kan gaan gebruiken. Ik besloot om de library in NetBeans IDE 6.7 te programmeren. Dit bleek heel eenvoudig. Met behulp van de Web Service Client wizard kan het Maven POM bestand worden gegenereerd. In de wizard heb ik gekozen voor JAX-WS Style. De WSDL van de webservice staat op de volgende locatie: WSDL. Hieronder de gegenereerde POM:

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.amazon.webservices</groupId>
  <artifactId>aws-ecommerce-service</artifactId>
  <packaging>jar</packaging>
  <version>2009_10_01</version>
  <name>AWSECommerceServicet</name>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>2.0.2</version>
        <configuration>
          <source>1.5</source>
          <target>1.5</target>
        </configuration>
      </plugin>
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>jaxws-maven-plugin</artifactId>
        <version>1.10</version>
        <executions>
          <execution>
            <goals>
              <goal>wsimport</goal>
            </goals>
            <configuration>
              <wsdlFiles>
                <wsdlFile>AWSECommerceService.wsdl</wsdlFile>
              </wsdlFiles>
              <staleFile>${project.build.directory}
              /jaxws/stale/AWSECommerceService.stale</staleFile>
            </configuration>
            <id>wsimport-generate-AWSECommerceService</id>
            <phase>generate-sources</phase>
          </execution>
        </executions>
        <dependencies>
          <dependency>
            <groupId>javax.xml</groupId>
            <artifactId>webservices-api</artifactId>
            <version>1.4</version>
          </dependency>
        </dependencies>
      </plugin>
    </plugins>
  </build>
  <dependencies>
    <dependency>
      <groupId>com.sun.xml.ws</groupId>
      <artifactId>webservices-rt</artifactId>
      <version>1.4</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>
</project>

Met behulp van het Maven commando mvn clean install wordt de library gegenereerd, gecompileerd en geïnstalleerd in de lokale Maven repository.

In een ander Maven project gebruik ik deze library. Dit project fungeert als een soort adapter. Uiteindelijk wil ik vanuit de applicatie alleen een simpele interface aanspreken om boek-informatie op te halen:

public interface BookService {
  public abstract Book findByISBN(String isbn);
}

Het toevoegen van de authenticatie code bleek nog niet zo eenvoudig. Met behulp van een SOAPHandler is de Header van een SOAP bericht te manipuleren:

public Book findByISBN(String isbn) {
  AWSECommerceService awsecommerceservice = new AWSECommerceService();
  awsecommerceservice.setHandlerResolver(new HandlerResolver() {
    @Override
    public List<Handler> getHandlerChain(PortInfo portInfo) {
      List<Handler> handlerList = new ArrayList<Handler>();
      handlerList.add(new AmazonSOAPHandler());
      return handlerList;
    }
  });
  AWSECommerceServicePortType awsecommerceserviceport =
      awsecommerceservice.getAWSECommerceServicePort();
  List<ItemLookupRequest> request = createItemLookupRequest(isbn);
  Holder<List<Items>> items = new Holder<List<Items>>();
  awsecommerceserviceport.itemLookup(null, AWS_ACCESS_KEY_ID, null, null,
      null, null, null, request, null, items);
  return parseResults(items);
}

De SOAPHandler bevat de volgende methode om de Header aan te passen:

public boolean handleMessage(SOAPMessageContext context) {
  Boolean outboundProperty =
      (Boolean) context.get(MessageContext.MESSAGE_OUTBOUND_PROPERTY);
  if (outboundProperty.booleanValue()) {
    try {
      AmazonSOAPHeaderData headerData = new AmazonSOAPHeaderData();
      SOAPEnvelope envelope = context.getMessage().getSOAPPart().getEnvelope();
      SOAPHeader header = envelope.addHeader();
      headerData.addInformationToSOAPHeader(header);
    } catch (Exception ex) {
      Logger.getLogger(AmazonSOAPHandler.class.getName()).log(Level.SEVERE, null, ex);
    }
  }
  return true;
}

AmazonSOAPHeaderData class bevat de informatie die in de header moet worden toegevoegd. Tevens wordt de ‘handtekening’ (Signature) in deze class berekend. Deze is bijna identiek aan het algoritme in de documenentatie van Amazon. Ik moest een kleine aanpassing doen om de code correct te laten werken:

public class AmazonSOAPHeaderData {

    private static final String UTF8_CHARSET = "UTF-8";
    private static final String HMAC_SHA256_ALGORITHM = "HmacSHA256";
    private String awsAccessKeyId = "XXXXXXXXXXXXXXXXXXXX";
    private String awsSecretKey = "SSSSSSSSSSSSSSSSSSSSSSSS";
    private String action = "ItemLookup";
    private static final String prefix = "aws";
    private static final String uri = "http://security.amazonaws.com/doc/2007-01-01/";
    private SecretKeySpec secretKeySpec = null;
    private Mac mac = null;

    public AmazonSOAPHeaderData() {
        try {
            byte[] secretyKeyBytes = awsSecretKey.getBytes(UTF8_CHARSET);
            secretKeySpec = new SecretKeySpec(secretyKeyBytes, HMAC_SHA256_ALGORITHM);
            mac = Mac.getInstance(HMAC_SHA256_ALGORITHM);
            mac.init(secretKeySpec);
        } catch (Exception e) {
            throw new RuntimeException(HMAC_SHA256_ALGORITHM + " is unsupported!", e);
        }
    }

    private String hmac(String stringToSign) {
        String sig = "";
        byte[] data;
        byte[] rawHmac;
        try {
            data = stringToSign.getBytes(UTF8_CHARSET);
            rawHmac = mac.doFinal(data);
            Base64 encoder = new Base64();
            sig = new String(encoder.encode(rawHmac));
        } catch (UnsupportedEncodingException e) {
            throw new RuntimeException(UTF8_CHARSET + " is unsupported!", e);
        }
        return sig.trim();
    }

    private String createTimestamp() {
        Calendar cal = Calendar.getInstance();
        DateFormat dfm = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss'Z'");
        dfm.setTimeZone(TimeZone.getTimeZone("GMT"));
        return dfm.format(cal.getTime());
    }

    public void addInformationToSOAPHeader(SOAPHeader header) throws SOAPException {
        SOAPFactory factory = SOAPFactory.newInstance();
        String timestamp = createTimestamp();
        String signature = hmac(action + timestamp);

        SOAPElement accessKeyElem =
                factory.createElement("AWSAccessKeyId", prefix, uri);
        accessKeyElem.addTextNode(awsAccessKeyId);
        SOAPElement timestampElem =
                factory.createElement("Timestamp", prefix, uri);
        timestampElem.addTextNode(timestamp);
        SOAPElement signatureElem =
                factory.createElement("Signature", prefix, uri);
        signatureElem.addTextNode(signature);

        header.addChildElement(accessKeyElem);
        header.addChildElement(timestampElem);
        header.addChildElement(signatureElem);
    }
}

Met deze code is het mogelijk om boekinformatie op te halen. De complete broncode staat hier. Uiteraard moet je om gebruik te maken van de Product Advertising API een account aanvragen. Dit is gratis en staat verder beschreven op de website van de Amazon WebServices.