View Source

Summary

Package	Description
proton.core (alternatively, proton)	Core protocol model and utility classes
proton.codec	AMQP data and frame encoding and decoding
proton.reactor	IO integration, event dispatch, and event handlers
proton.security	Encryption and authentication
proton.messenger	A home for the Messenger API
proton.extras	Extra classes that extend core Proton functionality
proton.util	Utility classes not supplied by the host language

The base Proton exception or error class goes in 'proton', but subclasses would reside in the various subpackages above.

There are some classes we intend to deprecate or remove: Connector, Listener, Driver.

Package 'proton.core'

Connection, Session, Link, Terminus, Delivery, Transport, Address, Condition - AMQP model objects
Message, Url, Data - Important user-facing utility classes
ProtonException - Core error handling

Package 'proton.codec'

Encoder, Decoder

Package 'proton.reactor'

Reactor, Container
Collector, Event, EventType, EventHandler
MessagingHandler, IncomingMessageHandler, OutgoingMessageHandler

Package 'proton.security'

SSL, SASL

Package 'proton.messenger'

Optional. Not every binding will include the Messenger API.

Messenger, Subscription

Package 'proton.util'

Optional. A place for simple extensions to the language-provided standard library. If the utility classes can be kept private, that's better still.

Logging classes
Timestamp, Described, UnsignedLong, etc. - Data types not supplied by the host language

Package 'proton.extras'

Optional. A place for end-user extensions to the core API.

BlockingConnection

Changes

As of 15 September 2015, I've tried to simplify the proposed structure.

Removed proton.event. Most bindings won't include this older variant of the event API. Instead, these classes can go under proton.reactor.
Removed proton.types. These are host language extensions, the same as the classes in proton.util. Such types are moved to proton.util.
Moved Url and Data to proton.core. They are part of the core user experience, across programming models.