From 5d81ad0dea5d916b08903c65f157eefaa826a33e Mon Sep 17 00:00:00 2001 From: Philipp Wollermann Date: Fri, 11 Mar 2016 22:43:42 +0100 Subject: Add grpc-java 0.13.2 to //third_party/grpc. --- third_party/grpc/LICENSE | 28 +++++ third_party/grpc/NOTICE.txt | 41 +++++++ third_party/grpc/PATENTS | 22 ++++ third_party/grpc/README.md | 226 +++++++++++++++++++++++++++++++++++ third_party/grpc/grpc-all-0.13.2.jar | Bin 0 -> 557292 bytes 5 files changed, 317 insertions(+) create mode 100644 third_party/grpc/LICENSE create mode 100644 third_party/grpc/NOTICE.txt create mode 100644 third_party/grpc/PATENTS create mode 100644 third_party/grpc/README.md create mode 100644 third_party/grpc/grpc-all-0.13.2.jar (limited to 'third_party/grpc') diff --git a/third_party/grpc/LICENSE b/third_party/grpc/LICENSE new file mode 100644 index 0000000000..2acb3d7503 --- /dev/null +++ b/third_party/grpc/LICENSE @@ -0,0 +1,28 @@ +Copyright 2014, Google Inc. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. \ No newline at end of file diff --git a/third_party/grpc/NOTICE.txt b/third_party/grpc/NOTICE.txt new file mode 100644 index 0000000000..ee67bad4ba --- /dev/null +++ b/third_party/grpc/NOTICE.txt @@ -0,0 +1,41 @@ +Copyright 2014, Google Inc. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +----------------------------------------------------------------------- + +This product contains a modified portion of 'OkHttp', an open source +HTTP & SPDY client for Android and Java applications, which can be obtained +at: + + * LICENSE: + * okhttp/third_party/okhttp/LICENSE (Apache License 2.0) + * HOMEPAGE: + * https://github.com/square/okhttp + * LOCATION_IN_GRPC: + * okhttp/third_party/okhttp \ No newline at end of file diff --git a/third_party/grpc/PATENTS b/third_party/grpc/PATENTS new file mode 100644 index 0000000000..619f9dbfe6 --- /dev/null +++ b/third_party/grpc/PATENTS @@ -0,0 +1,22 @@ +Additional IP Rights Grant (Patents) + +"This implementation" means the copyrightable works distributed by +Google as part of the GRPC project. + +Google hereby grants to You a perpetual, worldwide, non-exclusive, +no-charge, royalty-free, irrevocable (except as stated in this section) +patent license to make, have made, use, offer to sell, sell, import, +transfer and otherwise run, modify and propagate the contents of this +implementation of GRPC, where such license applies only to those patent +claims, both currently owned or controlled by Google and acquired in +the future, licensable by Google that are necessarily infringed by this +implementation of GRPC. This grant does not include claims that would be +infringed only as a consequence of further modification of this +implementation. If you or your agent or exclusive licensee institute or +order or agree to the institution of patent litigation against any +entity (including a cross-claim or counterclaim in a lawsuit) alleging +that this implementation of GRPC or any code incorporated within this +implementation of GRPC constitutes direct or contributory patent +infringement, or inducement of patent infringement, then any patent +rights granted to you under this License for this implementation of GRPC +shall terminate as of the date such litigation is filed. diff --git a/third_party/grpc/README.md b/third_party/grpc/README.md new file mode 100644 index 0000000000..186678b544 --- /dev/null +++ b/third_party/grpc/README.md @@ -0,0 +1,226 @@ +gRPC-Java - An RPC library and framework +======================================== + +gRPC-Java works with JDK 6. TLS usage typically requires using Java 8, or Play +Services Dynamic Security Provider on Android. Please see the [Security +Readme](SECURITY.md). + + + + + + + + + + +
Homepage:www.grpc.io
Mailing List:grpc-io@googlegroups.com
+ +[![Build Status](https://travis-ci.org/grpc/grpc-java.svg?branch=master)](https://travis-ci.org/grpc/grpc-java) +[![Coverage Status](https://coveralls.io/repos/grpc/grpc-java/badge.svg?branch=master&service=github)](https://coveralls.io/github/grpc/grpc-java?branch=master) + +Download +-------- + +Download [the JAR][]. Or for Maven, add to your `pom.xml`: +```xml + + io.grpc + grpc-all + 0.13.2 + +``` + +Or for Gradle, add to your dependencies: +```gradle +compile 'io.grpc:grpc-all:0.13.2' +``` + +For Android client, you only need to depend on the needed sub-projects, such as: +```gradle +compile 'io.grpc:grpc-okhttp:0.13.2' +compile 'io.grpc:grpc-protobuf-nano:0.13.2' +compile 'io.grpc:grpc-stub:0.13.2' +``` + +[the JAR]: https://search.maven.org/remote_content?g=io.grpc&a=grpc-all&v=0.13.2 + +Development snapshots are available in [Sonatypes's snapshot +repository](https://oss.sonatype.org/content/repositories/snapshots/). + +For protobuf-based codegen, you can put your proto files in the `src/main/proto` +and `src/test/proto` directories along with an appropriate plugin. + +For protobuf-based codegen integrated with the Maven build system, you can use +[protobuf-maven-plugin][]: +```xml + + + + kr.motd.maven + os-maven-plugin + 1.4.1.Final + + + + + org.xolstice.maven.plugins + protobuf-maven-plugin + 0.5.0 + + + com.google.protobuf:protoc:3.0.0-beta-2:exe:${os.detected.classifier} + grpc-java + io.grpc:protoc-gen-grpc-java:0.13.2:exe:${os.detected.classifier} + + + + + compile + compile-custom + + + + + + +``` + +[protobuf-maven-plugin]: https://www.xolstice.org/protobuf-maven-plugin/ + +For protobuf-based codegen integrated with the Gradle build system, you can use +[protobuf-gradle-plugin][]: +```gradle +apply plugin: 'java' +apply plugin: 'com.google.protobuf' + +buildscript { + repositories { + mavenCentral() + } + dependencies { + classpath 'com.google.protobuf:protobuf-gradle-plugin:0.7.4' + } +} + +protobuf { + protoc { + // The version of protoc must match protobuf-java. If you don't depend on + // protobuf-java directly, you will be transitively depending on the + // protobuf-java version that grpc depends on. + artifact = "com.google.protobuf:protoc:3.0.0-beta-2" + } + plugins { + grpc { + artifact = 'io.grpc:protoc-gen-grpc-java:0.13.2' + } + } + generateProtoTasks { + all()*.plugins { + grpc {} + } + } +} +``` + +[protobuf-gradle-plugin]: https://github.com/google/protobuf-gradle-plugin + +How to Build +------------ + +If you are making changes to gRPC-Java, see the [compiling +instructions](COMPILING.md). + +Navigating Around the Source +---------------------------- + +Here's a quick readers' guide to the code to help folks get started. At a high +level there are three distinct layers to the library: __Stub__, __Channel__ & +__Transport__. + +### Stub + +The Stub layer is what is exposed to most developers and provides type-safe +bindings to whatever datamodel/IDL/interface you are adapting. gRPC comes with +a [plugin](https://github.com/google/grpc-java/blob/master/compiler) to the +protocol-buffers compiler that generates Stub interfaces out of `.proto` files, +but bindings to other datamodel/IDL should be trivial to add and are welcome. + +#### Key Interfaces + +[Stream Observer](https://github.com/google/grpc-java/blob/master/stub/src/main/java/io/grpc/stub/StreamObserver.java) + +### Channel + +The Channel layer is an abstraction over Transport handling that is suitable for +interception/decoration and exposes more behavior to the application than the +Stub layer. It is intended to be easy for application frameworks to use this +layer to address cross-cutting concerns such as logging, monitoring, auth etc. +Flow-control is also exposed at this layer to allow more sophisticated +applications to interact with it directly. + +#### Common + +* [Metadata - headers & trailers](https://github.com/google/grpc-java/blob/master/core/src/main/java/io/grpc/Metadata.java) +* [Status - error code namespace & handling](https://github.com/google/grpc-java/blob/master/core/src/main/java/io/grpc/Status.java) + +#### Client +* [Channel - client side binding](https://github.com/google/grpc-java/blob/master/core/src/main/java/io/grpc/Channel.java) +* [Client Call](https://github.com/google/grpc-java/blob/master/core/src/main/java/io/grpc/ClientCall.java) +* [Client Interceptor](https://github.com/google/grpc-java/blob/master/core/src/main/java/io/grpc/ClientInterceptor.java) + +#### Server +* [Server call handler - analog to Channel on server](https://github.com/google/grpc-java/blob/master/core/src/main/java/io/grpc/ServerCallHandler.java) +* [Server Call](https://github.com/google/grpc-java/blob/master/core/src/main/java/io/grpc/ServerCall.java) + + +### Transport + +The Transport layer does the heavy lifting of putting and taking bytes off the +wire. The interfaces to it are abstract just enough to allow plugging in of +different implementations. Transports are modeled as `Stream` factories. The +variation in interface between a server Stream and a client Stream exists to +codify their differing semantics for cancellation and error reporting. + +Note the transport layer API is considered internal to gRPC and has weaker API +guarantees than the core API under package `io.grpc`. + +gRPC comes with three Transport implementations: + +1. The [Netty-based](https://github.com/google/grpc-java/blob/master/netty) + transport is the main transport implementation based on + [Netty](http://netty.io). It is for both the client and the server. +2. The [OkHttp-based](https://github.com/google/grpc-java/blob/master/okhttp) + transport is a lightweight transport based on + [OkHttp](http://square.github.io/okhttp/). It is mainly for use on Android + and is for client only. +3. The + [inProcess](https://github.com/google/grpc-java/blob/master/core/src/main/java/io/grpc/inprocess) + transport is for when a server is in the same process as the client. It is + useful for testing. + +#### Common + +* [Stream](https://github.com/google/grpc-java/blob/master/core/src/main/java/io/grpc/internal/Stream.java) +* [Stream Listener](https://github.com/google/grpc-java/blob/master/core/src/main/java/io/grpc/internal/StreamListener.java) + +#### Client + +* [Client Stream](https://github.com/google/grpc-java/blob/master/core/src/main/java/io/grpc/internal/ClientStream.java) +* [Client Stream Listener](https://github.com/google/grpc-java/blob/master/core/src/main/java/io/grpc/internal/ClientStreamListener.java) + +#### Server + +* [Server Stream](https://github.com/google/grpc-java/blob/master/core/src/main/java/io/grpc/internal/ServerStream.java) +* [Server Stream Listener](https://github.com/google/grpc-java/blob/master/core/src/main/java/io/grpc/internal/ServerStreamListener.java) + + +### Examples + +Tests showing how these layers are composed to execute calls using protobuf +messages can be found here +https://github.com/google/grpc-java/tree/master/interop-testing/src/main/java/io/grpc/testing/integration diff --git a/third_party/grpc/grpc-all-0.13.2.jar b/third_party/grpc/grpc-all-0.13.2.jar new file mode 100644 index 0000000000..71ed77edfc Binary files /dev/null and b/third_party/grpc/grpc-all-0.13.2.jar differ -- cgit v1.2.3