API Common for Java

• Documentation

API Common for Java is a library for foundational types relating to Google
APIs. It currently contains the following packages:

• core: Core library containing API stability annotations and wrappers around
  Guava types
• pathtemplate: Path Template library for manipulating strings that are
  formatted as Google API resource names.
• resourcenames: Resource Name library used by generated resource name types

Java Versions

Java 7 or above is required for using this library.

Contributing

Contributions to this library are always welcome and highly encouraged.

See the CONTRIBUTING documentation for more information on how to get started.

Versioning

This library follows Semantic Versioning, but with some
additional qualifications:

1. Components marked with @BetaApi are considered to be "0.x" features inside
   a "1.x" library. This means they can change between minor and patch releases
   in incompatible ways. These features should not be used by any library "B"
   that itself has consumers, unless the components of library B that use
   @BetaApi features are also marked with @BetaApi. Features marked as
   @BetaApi are on a path to eventually become "1.x" features with the marker
   removed.
2. Components marked with @InternalApi are technically public, but are only
   public for technical reasons, because of the limitations of Java's access
   modifiers. For the purposes of semver, they should be considered private.

This library is currently in major version zero (0.y.z), which means that
anything may change at any time and the public API should not be considered
stable.

License

BSD - See LICENSE for more information.