1. Introduction

This document explains how to use the Java client for AMPS. Use this document to learn how to install, configure, develop applications using AMPS.

Prerequisites

Before reading this book, it is important to have a good understanding of the following topics:

  • Developing in Java. To be successful using this guide, you will need to possess a working knowledge of the Java language. Visit http://java.oracle.com for resources on learning Java.
  • AMPS concepts. Before reading this guide, you will need to understand the basic concepts of AMPS, such as topics, subscriptions, messages, and SOW. Consult the AMPS Users’ Guide to learn more about these topics before proceeding.

You will need an installed and running AMPS server to use the product as well. You can write and compile programs that use AMPS without a running server, but you will get the most out of this guide by running the programs against a working server.

Upgrading from a Previous Version of the AMPS Java Client

The AMPS Java client is designed to maintain binary compatibility for hotfix versions, unless otherwise specified in the release notes.

For versions that introduce or change features, as indicated by a change to the major or minor version number, 60East cannot guarantee binary compatibility. An upgrade that changes either a major or minor version number may require a recompile from source. Changes that do not affect source compatibility are not generally noted in upgrade documents when the major or minor version numbers change.

For example, an upgrade from X.Y.1.0 to X.Y.1.1 of the Java client would be a drop-in replacement unless otherwise noted, as would an upgrade from X.Y.1.1 to X.Y.2.7. However, an upgrade from X.Y.2.7 to X.Z.0.0 may require that you recompile your application from source.