Programming with the ALE and ALEPC APIs

Introduction and Roadmap

Document Scope and Audience

Guide to This Document

Related Documentation

EPCglobal Standards Compliance

New and Changed Features in This Release

stableCount Element

Gen2 Support

Using RFID Samples to Develop Applications

Reading and Writing Tags

Overview of the ALE API and ALE Operation

BEA Implementation of the ALE API

Benefits of the BEA Implementation

Programming Methods

Reading Tag Data

Read Cycles and Event Cycles

Smoothing Read Cycles with Transient Filtering

How Applications Interact with the Edge Server ALE Engine

ECSpec Reports

Writing Tag Data

Programming Cycles

Reader Implementation of Programming Cycles

EPC Caches

Creating Tag Caches

PCSpec Reports

Comparison of Event Cycles and Programming Cycles

Asynchronous Notification Mechanisms

Overview of Asynchronous Notification Mechanisms

Encoded XML Through HTTP POST

Encoded XML Through TCP Socket

Encoded XML in JMS Message

Examples of Report Delivery by Using XML with JMS

XML Written to a File

XML Displayed on the Edge Server Console

XML Sent to a Workflow Module

Event Triggers

Overview of Event Triggers

OLE for Process Control (OPC) Trigger Driver

Reading Tags by Using the ALE API

Overview of the ALE API Implementation

ALE: Main Tag Reading Interface with UML Diagrams

State Diagram

Primary ALE API Data Types

ECSpec Data Type

ECBoundarySpec

ECBoundarySpec Implementation Notes

ECTime

ECTimeUnit

ECTrigger

ECReportSpec

ECReportSpec Implementation Notes

ECReportSetSpec

ECFilterSpec

EPC Patterns

ECGroupSpec

About Group Reports

Examples of Pattern URIs Used as Grouping Patterns

ECReportOutputSpec

ECReports Data Type

ECTerminationCondition

ECReport

ECReportGroup

ECReportGroupList

ECReportGroupListMember

ECReportGroupCount

ECReportGroupListMemberMemory

Other ALE API Types: BEA Extensions

ECSpecInfo (WebLogic RFID Edge Server Extension)

ECSubscriptionInfo (WebLogic RFID Edge Server Extension)

ECSubscriptionControls (WebLogic RFID Edge Server Extension)

XML Representations

ECSpec - Example

ECReports - Example

Using the ALE Tag Reading API from Java

Using XML Serializers and Deserializers from Java

Gen2 Read Support

includedMemory

getMemoryItem

Writing Tags by Using the ALEPC API

Overview of the ALEPC API Implementation

ALEPC: Main Tag Writing Interface with UML Diagrams

PCSpec

PCSpecInfo

PCSubscriptionControls

PCSubscriptionInfo

AccessSpec

OpSpec

DataSpec

PCWriteReport

AccessReport

TagReport

OpReport

PCStatus

PCTerminationCondition

EPCCacheSpec

EPCCacheReport

EPCCacheSpecInfo

EPCPatterns

XML Representations

PCSpec - Example

PCWriteReport - Example

EPCCacheSpec - Example

EPCCacheReport - Example

XML Schema for PCSpec, PCWriteReport, EPCCacheSpec, and EPCCacheReport

Using the ALEPC Tag Writing API from Java

Using XML Serializers and Deserializers from Java

BEA Gen2 Write Support

Extended API Support

Multiple Tags in Field

Parameter Substitutions

Gen2 PCSpec Examples

readEPCBank.xml

readAbsolute.xml

readPassword.xml

writePassword.xml

writePasswords.xml

writeTagMemory.xml

writeTagMemory.xml and PCWriteReport.xml

kill.xml

lock.xml

stackLight.xml

Sample Java Applications

Overview of Sample Java Applications

Setting Up Your Development Environment

Compiling and Running the Samples

ImmediateSample: Getting Started Reading Tags

Using ImmediateSample with the Administration Console

ImmediateSample: Event Cycles and Reliability

ImmediateSample: Reading from Different Readers

SubscribeSample: Exploring Asynchronous Event Cycle Delivery

SubscribeSample Command Line Options

ImmediateProgramSample: Writing Tags

Using ImmediateProgramSample with the Reader Simulator

ProgrammingSample: Exploring Programming Cycles and EPC Caches

JMS Samples

Workflow Sample XML Files