diff --git a/grpc-common/PROTOCOL-HTTP2.md b/doc/PROTOCOL-HTTP2.md similarity index 100% rename from grpc-common/PROTOCOL-HTTP2.md rename to doc/PROTOCOL-HTTP2.md diff --git a/grpc-common/grpc-auth-support.md b/doc/grpc-auth-support.md similarity index 100% rename from grpc-common/grpc-auth-support.md rename to doc/grpc-auth-support.md diff --git a/grpc-common/README.md b/examples/README.md similarity index 100% rename from grpc-common/README.md rename to examples/README.md diff --git a/grpc-common/cpp/README.md b/examples/cpp/README.md similarity index 100% rename from grpc-common/cpp/README.md rename to examples/cpp/README.md diff --git a/grpc-common/cpp/cpptutorial.md b/examples/cpp/cpptutorial.md similarity index 100% rename from grpc-common/cpp/cpptutorial.md rename to examples/cpp/cpptutorial.md diff --git a/grpc-common/cpp/helloworld/Makefile b/examples/cpp/helloworld/Makefile similarity index 100% rename from grpc-common/cpp/helloworld/Makefile rename to examples/cpp/helloworld/Makefile diff --git a/grpc-common/cpp/helloworld/README.md b/examples/cpp/helloworld/README.md similarity index 100% rename from grpc-common/cpp/helloworld/README.md rename to examples/cpp/helloworld/README.md diff --git a/grpc-common/cpp/helloworld/greeter_async_client.cc b/examples/cpp/helloworld/greeter_async_client.cc similarity index 100% rename from grpc-common/cpp/helloworld/greeter_async_client.cc rename to examples/cpp/helloworld/greeter_async_client.cc diff --git a/grpc-common/cpp/helloworld/greeter_async_server.cc b/examples/cpp/helloworld/greeter_async_server.cc similarity index 100% rename from grpc-common/cpp/helloworld/greeter_async_server.cc rename to examples/cpp/helloworld/greeter_async_server.cc diff --git a/grpc-common/cpp/helloworld/greeter_client.cc b/examples/cpp/helloworld/greeter_client.cc similarity index 100% rename from grpc-common/cpp/helloworld/greeter_client.cc rename to examples/cpp/helloworld/greeter_client.cc diff --git a/grpc-common/cpp/helloworld/greeter_server.cc b/examples/cpp/helloworld/greeter_server.cc similarity index 100% rename from grpc-common/cpp/helloworld/greeter_server.cc rename to examples/cpp/helloworld/greeter_server.cc diff --git a/grpc-common/cpp/route_guide/Makefile b/examples/cpp/route_guide/Makefile similarity index 100% rename from grpc-common/cpp/route_guide/Makefile rename to examples/cpp/route_guide/Makefile diff --git a/grpc-common/cpp/route_guide/helper.cc b/examples/cpp/route_guide/helper.cc similarity index 100% rename from grpc-common/cpp/route_guide/helper.cc rename to examples/cpp/route_guide/helper.cc diff --git a/grpc-common/cpp/route_guide/helper.h b/examples/cpp/route_guide/helper.h similarity index 100% rename from grpc-common/cpp/route_guide/helper.h rename to examples/cpp/route_guide/helper.h diff --git a/grpc-common/cpp/route_guide/route_guide_client.cc b/examples/cpp/route_guide/route_guide_client.cc similarity index 100% rename from grpc-common/cpp/route_guide/route_guide_client.cc rename to examples/cpp/route_guide/route_guide_client.cc diff --git a/grpc-common/cpp/route_guide/route_guide_db.json b/examples/cpp/route_guide/route_guide_db.json similarity index 100% rename from grpc-common/cpp/route_guide/route_guide_db.json rename to examples/cpp/route_guide/route_guide_db.json diff --git a/grpc-common/cpp/route_guide/route_guide_server.cc b/examples/cpp/route_guide/route_guide_server.cc similarity index 100% rename from grpc-common/cpp/route_guide/route_guide_server.cc rename to examples/cpp/route_guide/route_guide_server.cc diff --git a/grpc-common/csharp/.gitignore b/examples/csharp/.gitignore similarity index 100% rename from grpc-common/csharp/.gitignore rename to examples/csharp/.gitignore diff --git a/grpc-common/csharp/.nuget/packages.config b/examples/csharp/.nuget/packages.config similarity index 100% rename from grpc-common/csharp/.nuget/packages.config rename to examples/csharp/.nuget/packages.config diff --git a/grpc-common/csharp/Greeter.sln b/examples/csharp/Greeter.sln similarity index 100% rename from grpc-common/csharp/Greeter.sln rename to examples/csharp/Greeter.sln diff --git a/grpc-common/csharp/Greeter/.gitignore b/examples/csharp/Greeter/.gitignore similarity index 100% rename from grpc-common/csharp/Greeter/.gitignore rename to examples/csharp/Greeter/.gitignore diff --git a/grpc-common/csharp/Greeter/Greeter.csproj b/examples/csharp/Greeter/Greeter.csproj similarity index 100% rename from grpc-common/csharp/Greeter/Greeter.csproj rename to examples/csharp/Greeter/Greeter.csproj diff --git a/grpc-common/csharp/Greeter/Helloworld.cs b/examples/csharp/Greeter/Helloworld.cs similarity index 100% rename from grpc-common/csharp/Greeter/Helloworld.cs rename to examples/csharp/Greeter/Helloworld.cs diff --git a/grpc-common/csharp/Greeter/HelloworldGrpc.cs b/examples/csharp/Greeter/HelloworldGrpc.cs similarity index 100% rename from grpc-common/csharp/Greeter/HelloworldGrpc.cs rename to examples/csharp/Greeter/HelloworldGrpc.cs diff --git a/grpc-common/csharp/Greeter/Properties/AssemblyInfo.cs b/examples/csharp/Greeter/Properties/AssemblyInfo.cs similarity index 100% rename from grpc-common/csharp/Greeter/Properties/AssemblyInfo.cs rename to examples/csharp/Greeter/Properties/AssemblyInfo.cs diff --git a/grpc-common/csharp/Greeter/packages.config b/examples/csharp/Greeter/packages.config similarity index 100% rename from grpc-common/csharp/Greeter/packages.config rename to examples/csharp/Greeter/packages.config diff --git a/grpc-common/csharp/Greeter/protos/helloworld.proto b/examples/csharp/Greeter/protos/helloworld.proto similarity index 100% rename from grpc-common/csharp/Greeter/protos/helloworld.proto rename to examples/csharp/Greeter/protos/helloworld.proto diff --git a/grpc-common/csharp/GreeterClient/.gitignore b/examples/csharp/GreeterClient/.gitignore similarity index 100% rename from grpc-common/csharp/GreeterClient/.gitignore rename to examples/csharp/GreeterClient/.gitignore diff --git a/grpc-common/csharp/GreeterClient/GreeterClient.csproj b/examples/csharp/GreeterClient/GreeterClient.csproj similarity index 100% rename from grpc-common/csharp/GreeterClient/GreeterClient.csproj rename to examples/csharp/GreeterClient/GreeterClient.csproj diff --git a/grpc-common/csharp/GreeterClient/Program.cs b/examples/csharp/GreeterClient/Program.cs similarity index 100% rename from grpc-common/csharp/GreeterClient/Program.cs rename to examples/csharp/GreeterClient/Program.cs diff --git a/grpc-common/csharp/GreeterClient/Properties/AssemblyInfo.cs b/examples/csharp/GreeterClient/Properties/AssemblyInfo.cs similarity index 100% rename from grpc-common/csharp/GreeterClient/Properties/AssemblyInfo.cs rename to examples/csharp/GreeterClient/Properties/AssemblyInfo.cs diff --git a/grpc-common/csharp/GreeterClient/packages.config b/examples/csharp/GreeterClient/packages.config similarity index 100% rename from grpc-common/csharp/GreeterClient/packages.config rename to examples/csharp/GreeterClient/packages.config diff --git a/grpc-common/csharp/GreeterServer/.gitignore b/examples/csharp/GreeterServer/.gitignore similarity index 100% rename from grpc-common/csharp/GreeterServer/.gitignore rename to examples/csharp/GreeterServer/.gitignore diff --git a/grpc-common/csharp/GreeterServer/GreeterServer.csproj b/examples/csharp/GreeterServer/GreeterServer.csproj similarity index 100% rename from grpc-common/csharp/GreeterServer/GreeterServer.csproj rename to examples/csharp/GreeterServer/GreeterServer.csproj diff --git a/grpc-common/csharp/GreeterServer/Program.cs b/examples/csharp/GreeterServer/Program.cs similarity index 100% rename from grpc-common/csharp/GreeterServer/Program.cs rename to examples/csharp/GreeterServer/Program.cs diff --git a/grpc-common/csharp/GreeterServer/Properties/AssemblyInfo.cs b/examples/csharp/GreeterServer/Properties/AssemblyInfo.cs similarity index 100% rename from grpc-common/csharp/GreeterServer/Properties/AssemblyInfo.cs rename to examples/csharp/GreeterServer/Properties/AssemblyInfo.cs diff --git a/grpc-common/csharp/GreeterServer/packages.config b/examples/csharp/GreeterServer/packages.config similarity index 100% rename from grpc-common/csharp/GreeterServer/packages.config rename to examples/csharp/GreeterServer/packages.config diff --git a/grpc-common/csharp/README.md b/examples/csharp/README.md similarity index 100% rename from grpc-common/csharp/README.md rename to examples/csharp/README.md diff --git a/grpc-common/csharp/route_guide/.gitignore b/examples/csharp/route_guide/.gitignore similarity index 100% rename from grpc-common/csharp/route_guide/.gitignore rename to examples/csharp/route_guide/.gitignore diff --git a/grpc-common/csharp/route_guide/.nuget/packages.config b/examples/csharp/route_guide/.nuget/packages.config similarity index 100% rename from grpc-common/csharp/route_guide/.nuget/packages.config rename to examples/csharp/route_guide/.nuget/packages.config diff --git a/grpc-common/csharp/route_guide/README.md b/examples/csharp/route_guide/README.md similarity index 100% rename from grpc-common/csharp/route_guide/README.md rename to examples/csharp/route_guide/README.md diff --git a/grpc-common/csharp/route_guide/RouteGuide.sln b/examples/csharp/route_guide/RouteGuide.sln similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuide.sln rename to examples/csharp/route_guide/RouteGuide.sln diff --git a/grpc-common/csharp/route_guide/RouteGuide/Properties/AssemblyInfo.cs b/examples/csharp/route_guide/RouteGuide/Properties/AssemblyInfo.cs similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuide/Properties/AssemblyInfo.cs rename to examples/csharp/route_guide/RouteGuide/Properties/AssemblyInfo.cs diff --git a/grpc-common/csharp/route_guide/RouteGuide/RouteGuide.cs b/examples/csharp/route_guide/RouteGuide/RouteGuide.cs similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuide/RouteGuide.cs rename to examples/csharp/route_guide/RouteGuide/RouteGuide.cs diff --git a/grpc-common/csharp/route_guide/RouteGuide/RouteGuide.csproj b/examples/csharp/route_guide/RouteGuide/RouteGuide.csproj similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuide/RouteGuide.csproj rename to examples/csharp/route_guide/RouteGuide/RouteGuide.csproj diff --git a/grpc-common/csharp/route_guide/RouteGuide/RouteGuideGrpc.cs b/examples/csharp/route_guide/RouteGuide/RouteGuideGrpc.cs similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuide/RouteGuideGrpc.cs rename to examples/csharp/route_guide/RouteGuide/RouteGuideGrpc.cs diff --git a/grpc-common/csharp/route_guide/RouteGuide/RouteGuideUtil.cs b/examples/csharp/route_guide/RouteGuide/RouteGuideUtil.cs similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuide/RouteGuideUtil.cs rename to examples/csharp/route_guide/RouteGuide/RouteGuideUtil.cs diff --git a/grpc-common/csharp/route_guide/RouteGuide/packages.config b/examples/csharp/route_guide/RouteGuide/packages.config similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuide/packages.config rename to examples/csharp/route_guide/RouteGuide/packages.config diff --git a/grpc-common/csharp/route_guide/RouteGuide/protos/route_guide.proto b/examples/csharp/route_guide/RouteGuide/protos/route_guide.proto similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuide/protos/route_guide.proto rename to examples/csharp/route_guide/RouteGuide/protos/route_guide.proto diff --git a/grpc-common/csharp/route_guide/RouteGuide/route_guide_db.json b/examples/csharp/route_guide/RouteGuide/route_guide_db.json similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuide/route_guide_db.json rename to examples/csharp/route_guide/RouteGuide/route_guide_db.json diff --git a/grpc-common/csharp/route_guide/RouteGuideClient/App.config b/examples/csharp/route_guide/RouteGuideClient/App.config similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuideClient/App.config rename to examples/csharp/route_guide/RouteGuideClient/App.config diff --git a/grpc-common/csharp/route_guide/RouteGuideClient/Program.cs b/examples/csharp/route_guide/RouteGuideClient/Program.cs similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuideClient/Program.cs rename to examples/csharp/route_guide/RouteGuideClient/Program.cs diff --git a/grpc-common/csharp/route_guide/RouteGuideClient/Properties/AssemblyInfo.cs b/examples/csharp/route_guide/RouteGuideClient/Properties/AssemblyInfo.cs similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuideClient/Properties/AssemblyInfo.cs rename to examples/csharp/route_guide/RouteGuideClient/Properties/AssemblyInfo.cs diff --git a/grpc-common/csharp/route_guide/RouteGuideClient/RouteGuideClient.csproj b/examples/csharp/route_guide/RouteGuideClient/RouteGuideClient.csproj similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuideClient/RouteGuideClient.csproj rename to examples/csharp/route_guide/RouteGuideClient/RouteGuideClient.csproj diff --git a/grpc-common/csharp/route_guide/RouteGuideClient/packages.config b/examples/csharp/route_guide/RouteGuideClient/packages.config similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuideClient/packages.config rename to examples/csharp/route_guide/RouteGuideClient/packages.config diff --git a/grpc-common/csharp/route_guide/RouteGuideServer/App.config b/examples/csharp/route_guide/RouteGuideServer/App.config similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuideServer/App.config rename to examples/csharp/route_guide/RouteGuideServer/App.config diff --git a/grpc-common/csharp/route_guide/RouteGuideServer/Program.cs b/examples/csharp/route_guide/RouteGuideServer/Program.cs similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuideServer/Program.cs rename to examples/csharp/route_guide/RouteGuideServer/Program.cs diff --git a/grpc-common/csharp/route_guide/RouteGuideServer/Properties/AssemblyInfo.cs b/examples/csharp/route_guide/RouteGuideServer/Properties/AssemblyInfo.cs similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuideServer/Properties/AssemblyInfo.cs rename to examples/csharp/route_guide/RouteGuideServer/Properties/AssemblyInfo.cs diff --git a/grpc-common/csharp/route_guide/RouteGuideServer/RouteGuideImpl.cs b/examples/csharp/route_guide/RouteGuideServer/RouteGuideImpl.cs similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuideServer/RouteGuideImpl.cs rename to examples/csharp/route_guide/RouteGuideServer/RouteGuideImpl.cs diff --git a/grpc-common/csharp/route_guide/RouteGuideServer/RouteGuideServer.csproj b/examples/csharp/route_guide/RouteGuideServer/RouteGuideServer.csproj similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuideServer/RouteGuideServer.csproj rename to examples/csharp/route_guide/RouteGuideServer/RouteGuideServer.csproj diff --git a/grpc-common/csharp/route_guide/RouteGuideServer/packages.config b/examples/csharp/route_guide/RouteGuideServer/packages.config similarity index 100% rename from grpc-common/csharp/route_guide/RouteGuideServer/packages.config rename to examples/csharp/route_guide/RouteGuideServer/packages.config diff --git a/grpc-common/node/.gitignore b/examples/node/.gitignore similarity index 100% rename from grpc-common/node/.gitignore rename to examples/node/.gitignore diff --git a/grpc-common/node/README.md b/examples/node/README.md similarity index 100% rename from grpc-common/node/README.md rename to examples/node/README.md diff --git a/grpc-common/node/greeter_client.js b/examples/node/greeter_client.js similarity index 100% rename from grpc-common/node/greeter_client.js rename to examples/node/greeter_client.js diff --git a/grpc-common/node/greeter_server.js b/examples/node/greeter_server.js similarity index 100% rename from grpc-common/node/greeter_server.js rename to examples/node/greeter_server.js diff --git a/grpc-common/node/helloworld.proto b/examples/node/helloworld.proto similarity index 100% rename from grpc-common/node/helloworld.proto rename to examples/node/helloworld.proto diff --git a/grpc-common/node/package.json b/examples/node/package.json similarity index 100% rename from grpc-common/node/package.json rename to examples/node/package.json diff --git a/grpc-common/node/route_guide/README.md b/examples/node/route_guide/README.md similarity index 100% rename from grpc-common/node/route_guide/README.md rename to examples/node/route_guide/README.md diff --git a/grpc-common/node/route_guide/route_guide.proto b/examples/node/route_guide/route_guide.proto similarity index 100% rename from grpc-common/node/route_guide/route_guide.proto rename to examples/node/route_guide/route_guide.proto diff --git a/grpc-common/node/route_guide/route_guide_client.js b/examples/node/route_guide/route_guide_client.js similarity index 100% rename from grpc-common/node/route_guide/route_guide_client.js rename to examples/node/route_guide/route_guide_client.js diff --git a/grpc-common/node/route_guide/route_guide_db.json b/examples/node/route_guide/route_guide_db.json similarity index 100% rename from grpc-common/node/route_guide/route_guide_db.json rename to examples/node/route_guide/route_guide_db.json diff --git a/grpc-common/node/route_guide/route_guide_server.js b/examples/node/route_guide/route_guide_server.js similarity index 100% rename from grpc-common/node/route_guide/route_guide_server.js rename to examples/node/route_guide/route_guide_server.js diff --git a/grpc-common/objective-c/auth_sample/AuthSample.xcodeproj/project.pbxproj b/examples/objective-c/auth_sample/AuthSample.xcodeproj/project.pbxproj similarity index 100% rename from grpc-common/objective-c/auth_sample/AuthSample.xcodeproj/project.pbxproj rename to examples/objective-c/auth_sample/AuthSample.xcodeproj/project.pbxproj diff --git a/grpc-common/objective-c/auth_sample/AuthSample.xcodeproj/project.xcworkspace/contents.xcworkspacedata b/examples/objective-c/auth_sample/AuthSample.xcodeproj/project.xcworkspace/contents.xcworkspacedata similarity index 100% rename from grpc-common/objective-c/auth_sample/AuthSample.xcodeproj/project.xcworkspace/contents.xcworkspacedata rename to examples/objective-c/auth_sample/AuthSample.xcodeproj/project.xcworkspace/contents.xcworkspacedata diff --git a/grpc-common/objective-c/auth_sample/AuthTestService.podspec b/examples/objective-c/auth_sample/AuthTestService.podspec similarity index 100% rename from grpc-common/objective-c/auth_sample/AuthTestService.podspec rename to examples/objective-c/auth_sample/AuthTestService.podspec diff --git a/grpc-common/objective-c/auth_sample/MakeRPCViewController.h b/examples/objective-c/auth_sample/MakeRPCViewController.h similarity index 100% rename from grpc-common/objective-c/auth_sample/MakeRPCViewController.h rename to examples/objective-c/auth_sample/MakeRPCViewController.h diff --git a/grpc-common/objective-c/auth_sample/MakeRPCViewController.m b/examples/objective-c/auth_sample/MakeRPCViewController.m similarity index 100% rename from grpc-common/objective-c/auth_sample/MakeRPCViewController.m rename to examples/objective-c/auth_sample/MakeRPCViewController.m diff --git a/grpc-common/objective-c/auth_sample/Misc/AppDelegate.h b/examples/objective-c/auth_sample/Misc/AppDelegate.h similarity index 100% rename from grpc-common/objective-c/auth_sample/Misc/AppDelegate.h rename to examples/objective-c/auth_sample/Misc/AppDelegate.h diff --git a/grpc-common/objective-c/auth_sample/Misc/AppDelegate.m b/examples/objective-c/auth_sample/Misc/AppDelegate.m similarity index 100% rename from grpc-common/objective-c/auth_sample/Misc/AppDelegate.m rename to examples/objective-c/auth_sample/Misc/AppDelegate.m diff --git a/grpc-common/objective-c/auth_sample/Misc/Base.lproj/Main.storyboard b/examples/objective-c/auth_sample/Misc/Base.lproj/Main.storyboard similarity index 100% rename from grpc-common/objective-c/auth_sample/Misc/Base.lproj/Main.storyboard rename to examples/objective-c/auth_sample/Misc/Base.lproj/Main.storyboard diff --git a/grpc-common/objective-c/auth_sample/Misc/GoogleService-Info.plist b/examples/objective-c/auth_sample/Misc/GoogleService-Info.plist similarity index 100% rename from grpc-common/objective-c/auth_sample/Misc/GoogleService-Info.plist rename to examples/objective-c/auth_sample/Misc/GoogleService-Info.plist diff --git a/grpc-common/objective-c/auth_sample/Misc/Images.xcassets/AppIcon.appiconset/Contents.json b/examples/objective-c/auth_sample/Misc/Images.xcassets/AppIcon.appiconset/Contents.json similarity index 100% rename from grpc-common/objective-c/auth_sample/Misc/Images.xcassets/AppIcon.appiconset/Contents.json rename to examples/objective-c/auth_sample/Misc/Images.xcassets/AppIcon.appiconset/Contents.json diff --git a/grpc-common/objective-c/auth_sample/Misc/Images.xcassets/first.imageset/Contents.json b/examples/objective-c/auth_sample/Misc/Images.xcassets/first.imageset/Contents.json similarity index 100% rename from grpc-common/objective-c/auth_sample/Misc/Images.xcassets/first.imageset/Contents.json rename to examples/objective-c/auth_sample/Misc/Images.xcassets/first.imageset/Contents.json diff --git a/grpc-common/objective-c/auth_sample/Misc/Images.xcassets/first.imageset/first.pdf b/examples/objective-c/auth_sample/Misc/Images.xcassets/first.imageset/first.pdf similarity index 100% rename from grpc-common/objective-c/auth_sample/Misc/Images.xcassets/first.imageset/first.pdf rename to examples/objective-c/auth_sample/Misc/Images.xcassets/first.imageset/first.pdf diff --git a/grpc-common/objective-c/auth_sample/Misc/Images.xcassets/second.imageset/Contents.json b/examples/objective-c/auth_sample/Misc/Images.xcassets/second.imageset/Contents.json similarity index 100% rename from grpc-common/objective-c/auth_sample/Misc/Images.xcassets/second.imageset/Contents.json rename to examples/objective-c/auth_sample/Misc/Images.xcassets/second.imageset/Contents.json diff --git a/grpc-common/objective-c/auth_sample/Misc/Images.xcassets/second.imageset/second.pdf b/examples/objective-c/auth_sample/Misc/Images.xcassets/second.imageset/second.pdf similarity index 100% rename from grpc-common/objective-c/auth_sample/Misc/Images.xcassets/second.imageset/second.pdf rename to examples/objective-c/auth_sample/Misc/Images.xcassets/second.imageset/second.pdf diff --git a/grpc-common/objective-c/auth_sample/Misc/Info.plist b/examples/objective-c/auth_sample/Misc/Info.plist similarity index 100% rename from grpc-common/objective-c/auth_sample/Misc/Info.plist rename to examples/objective-c/auth_sample/Misc/Info.plist diff --git a/grpc-common/objective-c/auth_sample/Misc/main.m b/examples/objective-c/auth_sample/Misc/main.m similarity index 100% rename from grpc-common/objective-c/auth_sample/Misc/main.m rename to examples/objective-c/auth_sample/Misc/main.m diff --git a/grpc-common/objective-c/auth_sample/Podfile b/examples/objective-c/auth_sample/Podfile similarity index 100% rename from grpc-common/objective-c/auth_sample/Podfile rename to examples/objective-c/auth_sample/Podfile diff --git a/grpc-common/objective-c/auth_sample/README.md b/examples/objective-c/auth_sample/README.md similarity index 100% rename from grpc-common/objective-c/auth_sample/README.md rename to examples/objective-c/auth_sample/README.md diff --git a/grpc-common/objective-c/auth_sample/SelectUserViewController.h b/examples/objective-c/auth_sample/SelectUserViewController.h similarity index 100% rename from grpc-common/objective-c/auth_sample/SelectUserViewController.h rename to examples/objective-c/auth_sample/SelectUserViewController.h diff --git a/grpc-common/objective-c/auth_sample/SelectUserViewController.m b/examples/objective-c/auth_sample/SelectUserViewController.m similarity index 100% rename from grpc-common/objective-c/auth_sample/SelectUserViewController.m rename to examples/objective-c/auth_sample/SelectUserViewController.m diff --git a/grpc-common/objective-c/helloworld/HelloWorld.podspec b/examples/objective-c/helloworld/HelloWorld.podspec similarity index 100% rename from grpc-common/objective-c/helloworld/HelloWorld.podspec rename to examples/objective-c/helloworld/HelloWorld.podspec diff --git a/grpc-common/objective-c/helloworld/HelloWorld.xcodeproj/project.pbxproj b/examples/objective-c/helloworld/HelloWorld.xcodeproj/project.pbxproj similarity index 100% rename from grpc-common/objective-c/helloworld/HelloWorld.xcodeproj/project.pbxproj rename to examples/objective-c/helloworld/HelloWorld.xcodeproj/project.pbxproj diff --git a/grpc-common/objective-c/helloworld/HelloWorld.xcodeproj/project.xcworkspace/contents.xcworkspacedata b/examples/objective-c/helloworld/HelloWorld.xcodeproj/project.xcworkspace/contents.xcworkspacedata similarity index 100% rename from grpc-common/objective-c/helloworld/HelloWorld.xcodeproj/project.xcworkspace/contents.xcworkspacedata rename to examples/objective-c/helloworld/HelloWorld.xcodeproj/project.xcworkspace/contents.xcworkspacedata diff --git a/grpc-common/objective-c/helloworld/HelloWorld/AppDelegate.h b/examples/objective-c/helloworld/HelloWorld/AppDelegate.h similarity index 100% rename from grpc-common/objective-c/helloworld/HelloWorld/AppDelegate.h rename to examples/objective-c/helloworld/HelloWorld/AppDelegate.h diff --git a/grpc-common/objective-c/helloworld/HelloWorld/AppDelegate.m b/examples/objective-c/helloworld/HelloWorld/AppDelegate.m similarity index 100% rename from grpc-common/objective-c/helloworld/HelloWorld/AppDelegate.m rename to examples/objective-c/helloworld/HelloWorld/AppDelegate.m diff --git a/grpc-common/objective-c/helloworld/HelloWorld/Base.lproj/Main.storyboard b/examples/objective-c/helloworld/HelloWorld/Base.lproj/Main.storyboard similarity index 100% rename from grpc-common/objective-c/helloworld/HelloWorld/Base.lproj/Main.storyboard rename to examples/objective-c/helloworld/HelloWorld/Base.lproj/Main.storyboard diff --git a/grpc-common/objective-c/helloworld/HelloWorld/Images.xcassets/AppIcon.appiconset/Contents.json b/examples/objective-c/helloworld/HelloWorld/Images.xcassets/AppIcon.appiconset/Contents.json similarity index 100% rename from grpc-common/objective-c/helloworld/HelloWorld/Images.xcassets/AppIcon.appiconset/Contents.json rename to examples/objective-c/helloworld/HelloWorld/Images.xcassets/AppIcon.appiconset/Contents.json diff --git a/grpc-common/objective-c/helloworld/HelloWorld/Info.plist b/examples/objective-c/helloworld/HelloWorld/Info.plist similarity index 100% rename from grpc-common/objective-c/helloworld/HelloWorld/Info.plist rename to examples/objective-c/helloworld/HelloWorld/Info.plist diff --git a/grpc-common/objective-c/helloworld/HelloWorld/ViewController.m b/examples/objective-c/helloworld/HelloWorld/ViewController.m similarity index 100% rename from grpc-common/objective-c/helloworld/HelloWorld/ViewController.m rename to examples/objective-c/helloworld/HelloWorld/ViewController.m diff --git a/grpc-common/objective-c/helloworld/Podfile b/examples/objective-c/helloworld/Podfile similarity index 100% rename from grpc-common/objective-c/helloworld/Podfile rename to examples/objective-c/helloworld/Podfile diff --git a/grpc-common/objective-c/helloworld/README.md b/examples/objective-c/helloworld/README.md similarity index 100% rename from grpc-common/objective-c/helloworld/README.md rename to examples/objective-c/helloworld/README.md diff --git a/grpc-common/objective-c/helloworld/main.m b/examples/objective-c/helloworld/main.m similarity index 100% rename from grpc-common/objective-c/helloworld/main.m rename to examples/objective-c/helloworld/main.m diff --git a/grpc-common/objective-c/route_guide/Misc/AppDelegate.h b/examples/objective-c/route_guide/Misc/AppDelegate.h similarity index 100% rename from grpc-common/objective-c/route_guide/Misc/AppDelegate.h rename to examples/objective-c/route_guide/Misc/AppDelegate.h diff --git a/grpc-common/objective-c/route_guide/Misc/AppDelegate.m b/examples/objective-c/route_guide/Misc/AppDelegate.m similarity index 100% rename from grpc-common/objective-c/route_guide/Misc/AppDelegate.m rename to examples/objective-c/route_guide/Misc/AppDelegate.m diff --git a/grpc-common/objective-c/route_guide/Misc/Base.lproj/Main.storyboard b/examples/objective-c/route_guide/Misc/Base.lproj/Main.storyboard similarity index 100% rename from grpc-common/objective-c/route_guide/Misc/Base.lproj/Main.storyboard rename to examples/objective-c/route_guide/Misc/Base.lproj/Main.storyboard diff --git a/grpc-common/objective-c/route_guide/Misc/Images.xcassets/AppIcon.appiconset/Contents.json b/examples/objective-c/route_guide/Misc/Images.xcassets/AppIcon.appiconset/Contents.json similarity index 100% rename from grpc-common/objective-c/route_guide/Misc/Images.xcassets/AppIcon.appiconset/Contents.json rename to examples/objective-c/route_guide/Misc/Images.xcassets/AppIcon.appiconset/Contents.json diff --git a/grpc-common/objective-c/route_guide/Misc/Images.xcassets/first.imageset/Contents.json b/examples/objective-c/route_guide/Misc/Images.xcassets/first.imageset/Contents.json similarity index 100% rename from grpc-common/objective-c/route_guide/Misc/Images.xcassets/first.imageset/Contents.json rename to examples/objective-c/route_guide/Misc/Images.xcassets/first.imageset/Contents.json diff --git a/grpc-common/objective-c/route_guide/Misc/Images.xcassets/first.imageset/first.pdf b/examples/objective-c/route_guide/Misc/Images.xcassets/first.imageset/first.pdf similarity index 100% rename from grpc-common/objective-c/route_guide/Misc/Images.xcassets/first.imageset/first.pdf rename to examples/objective-c/route_guide/Misc/Images.xcassets/first.imageset/first.pdf diff --git a/grpc-common/objective-c/route_guide/Misc/Images.xcassets/second.imageset/Contents.json b/examples/objective-c/route_guide/Misc/Images.xcassets/second.imageset/Contents.json similarity index 100% rename from grpc-common/objective-c/route_guide/Misc/Images.xcassets/second.imageset/Contents.json rename to examples/objective-c/route_guide/Misc/Images.xcassets/second.imageset/Contents.json diff --git a/grpc-common/objective-c/route_guide/Misc/Images.xcassets/second.imageset/second.pdf b/examples/objective-c/route_guide/Misc/Images.xcassets/second.imageset/second.pdf similarity index 100% rename from grpc-common/objective-c/route_guide/Misc/Images.xcassets/second.imageset/second.pdf rename to examples/objective-c/route_guide/Misc/Images.xcassets/second.imageset/second.pdf diff --git a/grpc-common/objective-c/route_guide/Misc/Info.plist b/examples/objective-c/route_guide/Misc/Info.plist similarity index 100% rename from grpc-common/objective-c/route_guide/Misc/Info.plist rename to examples/objective-c/route_guide/Misc/Info.plist diff --git a/grpc-common/objective-c/route_guide/Misc/main.m b/examples/objective-c/route_guide/Misc/main.m similarity index 100% rename from grpc-common/objective-c/route_guide/Misc/main.m rename to examples/objective-c/route_guide/Misc/main.m diff --git a/grpc-common/objective-c/route_guide/Podfile b/examples/objective-c/route_guide/Podfile similarity index 100% rename from grpc-common/objective-c/route_guide/Podfile rename to examples/objective-c/route_guide/Podfile diff --git a/grpc-common/objective-c/route_guide/README.md b/examples/objective-c/route_guide/README.md similarity index 100% rename from grpc-common/objective-c/route_guide/README.md rename to examples/objective-c/route_guide/README.md diff --git a/grpc-common/objective-c/route_guide/RouteGuide.podspec b/examples/objective-c/route_guide/RouteGuide.podspec similarity index 100% rename from grpc-common/objective-c/route_guide/RouteGuide.podspec rename to examples/objective-c/route_guide/RouteGuide.podspec diff --git a/grpc-common/objective-c/route_guide/RouteGuideClient.xcodeproj/project.pbxproj b/examples/objective-c/route_guide/RouteGuideClient.xcodeproj/project.pbxproj similarity index 100% rename from grpc-common/objective-c/route_guide/RouteGuideClient.xcodeproj/project.pbxproj rename to examples/objective-c/route_guide/RouteGuideClient.xcodeproj/project.pbxproj diff --git a/grpc-common/objective-c/route_guide/RouteGuideClient.xcodeproj/project.xcworkspace/contents.xcworkspacedata b/examples/objective-c/route_guide/RouteGuideClient.xcodeproj/project.xcworkspace/contents.xcworkspacedata similarity index 100% rename from grpc-common/objective-c/route_guide/RouteGuideClient.xcodeproj/project.xcworkspace/contents.xcworkspacedata rename to examples/objective-c/route_guide/RouteGuideClient.xcodeproj/project.xcworkspace/contents.xcworkspacedata diff --git a/grpc-common/objective-c/route_guide/ViewControllers.m b/examples/objective-c/route_guide/ViewControllers.m similarity index 100% rename from grpc-common/objective-c/route_guide/ViewControllers.m rename to examples/objective-c/route_guide/ViewControllers.m diff --git a/grpc-common/objective-c/route_guide/route_guide_db.json b/examples/objective-c/route_guide/route_guide_db.json similarity index 100% rename from grpc-common/objective-c/route_guide/route_guide_db.json rename to examples/objective-c/route_guide/route_guide_db.json diff --git a/grpc-common/php/.gitignore b/examples/php/.gitignore similarity index 100% rename from grpc-common/php/.gitignore rename to examples/php/.gitignore diff --git a/grpc-common/php/README.md b/examples/php/README.md similarity index 100% rename from grpc-common/php/README.md rename to examples/php/README.md diff --git a/grpc-common/php/composer.json b/examples/php/composer.json similarity index 100% rename from grpc-common/php/composer.json rename to examples/php/composer.json diff --git a/grpc-common/php/greeter_client.php b/examples/php/greeter_client.php similarity index 100% rename from grpc-common/php/greeter_client.php rename to examples/php/greeter_client.php diff --git a/grpc-common/php/helloworld.php b/examples/php/helloworld.php similarity index 100% rename from grpc-common/php/helloworld.php rename to examples/php/helloworld.php diff --git a/grpc-common/php/helloworld.proto b/examples/php/helloworld.proto similarity index 100% rename from grpc-common/php/helloworld.proto rename to examples/php/helloworld.proto diff --git a/grpc-common/php/route_guide/README.md b/examples/php/route_guide/README.md similarity index 100% rename from grpc-common/php/route_guide/README.md rename to examples/php/route_guide/README.md diff --git a/grpc-common/php/route_guide/route_guide.php b/examples/php/route_guide/route_guide.php similarity index 100% rename from grpc-common/php/route_guide/route_guide.php rename to examples/php/route_guide/route_guide.php diff --git a/grpc-common/php/route_guide/route_guide.proto b/examples/php/route_guide/route_guide.proto similarity index 100% rename from grpc-common/php/route_guide/route_guide.proto rename to examples/php/route_guide/route_guide.proto diff --git a/grpc-common/php/route_guide/route_guide_client.php b/examples/php/route_guide/route_guide_client.php similarity index 100% rename from grpc-common/php/route_guide/route_guide_client.php rename to examples/php/route_guide/route_guide_client.php diff --git a/grpc-common/php/route_guide/run_route_guide_client.sh b/examples/php/route_guide/run_route_guide_client.sh similarity index 100% rename from grpc-common/php/route_guide/run_route_guide_client.sh rename to examples/php/route_guide/run_route_guide_client.sh diff --git a/grpc-common/php/run_greeter_client.sh b/examples/php/run_greeter_client.sh similarity index 100% rename from grpc-common/php/run_greeter_client.sh rename to examples/php/run_greeter_client.sh diff --git a/grpc-common/protos/README.md b/examples/protos/README.md similarity index 100% rename from grpc-common/protos/README.md rename to examples/protos/README.md diff --git a/grpc-common/protos/auth_sample.proto b/examples/protos/auth_sample.proto similarity index 100% rename from grpc-common/protos/auth_sample.proto rename to examples/protos/auth_sample.proto diff --git a/grpc-common/protos/hellostreamingworld.proto b/examples/protos/hellostreamingworld.proto similarity index 100% rename from grpc-common/protos/hellostreamingworld.proto rename to examples/protos/hellostreamingworld.proto diff --git a/grpc-common/protos/helloworld.proto b/examples/protos/helloworld.proto similarity index 100% rename from grpc-common/protos/helloworld.proto rename to examples/protos/helloworld.proto diff --git a/grpc-common/protos/route_guide.proto b/examples/protos/route_guide.proto similarity index 100% rename from grpc-common/protos/route_guide.proto rename to examples/protos/route_guide.proto diff --git a/grpc-common/python/helloworld/.gitignore b/examples/python/helloworld/.gitignore similarity index 100% rename from grpc-common/python/helloworld/.gitignore rename to examples/python/helloworld/.gitignore diff --git a/grpc-common/python/helloworld/README.md b/examples/python/helloworld/README.md similarity index 100% rename from grpc-common/python/helloworld/README.md rename to examples/python/helloworld/README.md diff --git a/grpc-common/python/helloworld/greeter_client.py b/examples/python/helloworld/greeter_client.py similarity index 100% rename from grpc-common/python/helloworld/greeter_client.py rename to examples/python/helloworld/greeter_client.py diff --git a/grpc-common/python/helloworld/greeter_server.py b/examples/python/helloworld/greeter_server.py similarity index 100% rename from grpc-common/python/helloworld/greeter_server.py rename to examples/python/helloworld/greeter_server.py diff --git a/grpc-common/python/helloworld/run_client.sh b/examples/python/helloworld/run_client.sh similarity index 100% rename from grpc-common/python/helloworld/run_client.sh rename to examples/python/helloworld/run_client.sh diff --git a/grpc-common/python/helloworld/run_codegen.sh b/examples/python/helloworld/run_codegen.sh similarity index 100% rename from grpc-common/python/helloworld/run_codegen.sh rename to examples/python/helloworld/run_codegen.sh diff --git a/grpc-common/python/helloworld/run_server.sh b/examples/python/helloworld/run_server.sh similarity index 100% rename from grpc-common/python/helloworld/run_server.sh rename to examples/python/helloworld/run_server.sh diff --git a/grpc-common/python/route_guide/.gitignore b/examples/python/route_guide/.gitignore similarity index 100% rename from grpc-common/python/route_guide/.gitignore rename to examples/python/route_guide/.gitignore diff --git a/grpc-common/python/route_guide/README.md b/examples/python/route_guide/README.md similarity index 100% rename from grpc-common/python/route_guide/README.md rename to examples/python/route_guide/README.md diff --git a/grpc-common/python/route_guide/route_guide_client.py b/examples/python/route_guide/route_guide_client.py similarity index 100% rename from grpc-common/python/route_guide/route_guide_client.py rename to examples/python/route_guide/route_guide_client.py diff --git a/grpc-common/python/route_guide/route_guide_db.json b/examples/python/route_guide/route_guide_db.json similarity index 100% rename from grpc-common/python/route_guide/route_guide_db.json rename to examples/python/route_guide/route_guide_db.json diff --git a/grpc-common/python/route_guide/route_guide_pb2.py b/examples/python/route_guide/route_guide_pb2.py similarity index 100% rename from grpc-common/python/route_guide/route_guide_pb2.py rename to examples/python/route_guide/route_guide_pb2.py diff --git a/grpc-common/python/route_guide/route_guide_resources.py b/examples/python/route_guide/route_guide_resources.py similarity index 100% rename from grpc-common/python/route_guide/route_guide_resources.py rename to examples/python/route_guide/route_guide_resources.py diff --git a/grpc-common/python/route_guide/route_guide_server.py b/examples/python/route_guide/route_guide_server.py similarity index 100% rename from grpc-common/python/route_guide/route_guide_server.py rename to examples/python/route_guide/route_guide_server.py diff --git a/grpc-common/python/route_guide/run_client.sh b/examples/python/route_guide/run_client.sh similarity index 100% rename from grpc-common/python/route_guide/run_client.sh rename to examples/python/route_guide/run_client.sh diff --git a/grpc-common/python/route_guide/run_codegen.sh b/examples/python/route_guide/run_codegen.sh similarity index 100% rename from grpc-common/python/route_guide/run_codegen.sh rename to examples/python/route_guide/run_codegen.sh diff --git a/grpc-common/python/route_guide/run_server.sh b/examples/python/route_guide/run_server.sh similarity index 100% rename from grpc-common/python/route_guide/run_server.sh rename to examples/python/route_guide/run_server.sh diff --git a/grpc-common/ruby/.gitignore b/examples/ruby/.gitignore similarity index 100% rename from grpc-common/ruby/.gitignore rename to examples/ruby/.gitignore diff --git a/grpc-common/ruby/Gemfile b/examples/ruby/Gemfile similarity index 100% rename from grpc-common/ruby/Gemfile rename to examples/ruby/Gemfile diff --git a/grpc-common/ruby/README.md b/examples/ruby/README.md similarity index 100% rename from grpc-common/ruby/README.md rename to examples/ruby/README.md diff --git a/grpc-common/ruby/greeter_client.rb b/examples/ruby/greeter_client.rb similarity index 100% rename from grpc-common/ruby/greeter_client.rb rename to examples/ruby/greeter_client.rb diff --git a/grpc-common/ruby/greeter_server.rb b/examples/ruby/greeter_server.rb similarity index 100% rename from grpc-common/ruby/greeter_server.rb rename to examples/ruby/greeter_server.rb diff --git a/grpc-common/ruby/grpc-demo.gemspec b/examples/ruby/grpc-demo.gemspec similarity index 100% rename from grpc-common/ruby/grpc-demo.gemspec rename to examples/ruby/grpc-demo.gemspec diff --git a/grpc-common/ruby/lib/helloworld.rb b/examples/ruby/lib/helloworld.rb similarity index 100% rename from grpc-common/ruby/lib/helloworld.rb rename to examples/ruby/lib/helloworld.rb diff --git a/grpc-common/ruby/lib/helloworld_services.rb b/examples/ruby/lib/helloworld_services.rb similarity index 100% rename from grpc-common/ruby/lib/helloworld_services.rb rename to examples/ruby/lib/helloworld_services.rb diff --git a/grpc-common/ruby/lib/route_guide.rb b/examples/ruby/lib/route_guide.rb similarity index 100% rename from grpc-common/ruby/lib/route_guide.rb rename to examples/ruby/lib/route_guide.rb diff --git a/grpc-common/ruby/lib/route_guide_services.rb b/examples/ruby/lib/route_guide_services.rb similarity index 100% rename from grpc-common/ruby/lib/route_guide_services.rb rename to examples/ruby/lib/route_guide_services.rb diff --git a/grpc-common/ruby/route_guide/README.md b/examples/ruby/route_guide/README.md similarity index 100% rename from grpc-common/ruby/route_guide/README.md rename to examples/ruby/route_guide/README.md diff --git a/grpc-common/ruby/route_guide/route_guide_client.rb b/examples/ruby/route_guide/route_guide_client.rb similarity index 100% rename from grpc-common/ruby/route_guide/route_guide_client.rb rename to examples/ruby/route_guide/route_guide_client.rb diff --git a/grpc-common/ruby/route_guide/route_guide_server.rb b/examples/ruby/route_guide/route_guide_server.rb similarity index 100% rename from grpc-common/ruby/route_guide/route_guide_server.rb rename to examples/ruby/route_guide/route_guide_server.rb diff --git a/grpc-common/LICENSE b/grpc-common/LICENSE deleted file mode 100644 index 05b6a757dab..00000000000 --- a/grpc-common/LICENSE +++ /dev/null @@ -1,28 +0,0 @@ -Copyright (c) 2015, grpc -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 grpc-common 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 HOLDER 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. - diff --git a/grpc-common/PATENTS b/grpc-common/PATENTS deleted file mode 100644 index 619f9dbfe63..00000000000 --- a/grpc-common/PATENTS +++ /dev/null @@ -1,22 +0,0 @@ -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/grpc-common/go/README.md b/grpc-common/go/README.md deleted file mode 100644 index 79db479ec58..00000000000 --- a/grpc-common/go/README.md +++ /dev/null @@ -1,53 +0,0 @@ -gRPC in 3 minutes (Go) -====================== - -BACKGROUND -------------- -For this sample, we've already generated the server and client stubs from [helloworld.proto](https://github.com/grpc/grpc-common/blob/master/protos/helloworld.proto). - -PREREQUISITES -------------- - -- This requires Go 1.4 -- Requires that [GOPATH is set](https://golang.org/doc/code.html#GOPATH) -```sh -$ go help gopath -$ # ensure the PATH contains $GOPATH/bin -$ export PATH=$PATH:$GOPATH/bin -``` - -INSTALL -------- - -```sh -$ go get -u github.com/grpc/grpc-common/go/greeter_client -$ go get -u github.com/grpc/grpc-common/go/greeter_server -``` - -TRY IT! -------- - -- Run the server -```sh -$ greeter_server & -``` - -- Run the client -```sh -$ greeter_client -``` - -OPTIONAL - Rebuilding the generated code ----------------------------------------- - -1 First [install protoc](https://github.com/google/protobuf/blob/master/INSTALL.txt) - - For now, this needs to be installed from source - - This is will change once proto3 is officially released - -2 Install the protoc Go plugin. -```sh -$ go get -a github.com/golang/protobuf/protoc-gen-go -$ -$ # from this dir; invoke protoc -$ protoc -I ../protos ../protos/helloworld.proto --go_out=plugins=grpc:helloworld -``` diff --git a/grpc-common/go/gotutorial.md b/grpc-common/go/gotutorial.md deleted file mode 100644 index 63f0ad90581..00000000000 --- a/grpc-common/go/gotutorial.md +++ /dev/null @@ -1,431 +0,0 @@ -#gRPC Basics: Go - -This tutorial provides a basic Go programmer's introduction to working with gRPC. By walking through this example you'll learn how to: - -- Define a service in a .proto file. -- Generate server and client code using the protocol buffer compiler. -- Use the Go gRPC API to write a simple client and server for your service. - -It assumes that you have read the [Getting started](https://github.com/grpc/grpc-common) guide and are familiar with [protocol buffers] (https://developers.google.com/protocol-buffers/docs/overview). Note that the example in this tutorial uses the proto3 version of the protocol buffers language, which is currently in alpha release:you can find out more in the [proto3 language guide](https://developers.google.com/protocol-buffers/docs/proto3) and see the [release notes](https://github.com/google/protobuf/releases) for the new version in the protocol buffers Github repository. - -This isn't a comprehensive guide to using gRPC in Go: more reference documentation is coming soon. - -## Why use gRPC? - -Our example is a simple route mapping application that lets clients get information about features on their route, create a summary of their route, and exchange route information such as traffic updates with the server and other clients. - -With gRPC we can define our service once in a .proto file and implement clients and servers in any of gRPC's supported languages, which in turn can be run in environments ranging from servers inside Google to your own tablet - all the complexity of communication between different languages and environments is handled for you by gRPC. We also get all the advantages of working with protocol buffers, including efficient serialization, a simple IDL, and easy interface updating. - -## Example code and setup - -The example code for our tutorial is in [grpc/grpc-go/examples/route_guide](https://github.com/grpc/grpc-go/tree/master/examples/route_guide). To download the example, clone the `grpc-go` repository by running the following command: -```shell -$ go get google.golang.org/grpc -``` - -Then change your current directory to `grpc-go/examples/route_guide`: -```shell -$ cd $GOPATH/src/google.golang.org/grpc/examples/route_guide -``` - -You also should have the relevant tools installed to generate the server and client interface code - if you don't already, follow the setup instructions in [the Go quick start guide](https://github.com/grpc/grpc-common/tree/master/go). - - -## Defining the service - -Our first step (as you'll know from [Getting started](https://github.com/grpc/grpc-common)) is to define the gRPC *service* and the method *request* and *response* types using [protocol buffers] (https://developers.google.com/protocol-buffers/docs/overview). You can see the complete .proto file in [`grpc-common/protos/route_guide.proto`](https://github.com/grpc/grpc-common/blob/master/protos/route_guide.proto). - -To define a service, you specify a named `service` in your .proto file: - -```proto -service RouteGuide { - ... -} -``` - -Then you define `rpc` methods inside your service definition, specifying their request and response types. gRPC lets you define four kinds of service method, all of which are used in the `RouteGuide` service: - -- A *simple RPC* where the client sends a request to the server using the stub and waits for a response to come back, just like a normal function call. -```proto - // Obtains the feature at a given position. - rpc GetFeature(Point) returns (Feature) {} -``` - -- A *server-side streaming RPC* where the client sends a request to the server and gets a stream to read a sequence of messages back. The client reads from the returned stream until there are no more messages. As you can see in our example, you specify a server-side streaming method by placing the `stream` keyword before the *response* type. -```proto - // Obtains the Features available within the given Rectangle. Results are - // streamed rather than returned at once (e.g. in a response message with a - // repeated field), as the rectangle may cover a large area and contain a - // huge number of features. - rpc ListFeatures(Rectangle) returns (stream Feature) {} -``` - -- A *client-side streaming RPC* where the client writes a sequence of messages and sends them to the server, again using a provided stream. Once the client has finished writing the messages, it waits for the server to read them all and return its response. You specify a client-side streaming method by placing the `stream` keyword before the *request* type. -```proto - // Accepts a stream of Points on a route being traversed, returning a - // RouteSummary when traversal is completed. - rpc RecordRoute(stream Point) returns (RouteSummary) {} -``` - -- A *bidirectional streaming RPC* where both sides send a sequence of messages using a read-write stream. The two streams operate independently, so clients and servers can read and write in whatever order they like: for example, the server could wait to receive all the client messages before writing its responses, or it could alternately read a message then write a message, or some other combination of reads and writes. The order of messages in each stream is preserved. You specify this type of method by placing the `stream` keyword before both the request and the response. -```proto - // Accepts a stream of RouteNotes sent while a route is being traversed, - // while receiving other RouteNotes (e.g. from other users). - rpc RouteChat(stream RouteNote) returns (stream RouteNote) {} -``` - -Our .proto file also contains protocol buffer message type definitions for all the request and response types used in our service methods - for example, here's the `Point` message type: -```proto -// Points are represented as latitude-longitude pairs in the E7 representation -// (degrees multiplied by 10**7 and rounded to the nearest integer). -// Latitudes should be in the range +/- 90 degrees and longitude should be in -// the range +/- 180 degrees (inclusive). -message Point { - int32 latitude = 1; - int32 longitude = 2; -} -``` - - -## Generating client and server code - -Next we need to generate the gRPC client and server interfaces from our .proto service definition. We do this using the protocol buffer compiler `protoc` with a special gRPC Go plugin. - -For simplicity, we've provided a [bash script](https://github.com/grpc/grpc-go/blob/master/codegen.sh) that runs `protoc` for you with the appropriate plugin, input, and output (if you want to run this by yourself, make sure you've installed protoc and followed the gRPC-Go [installation instructions](https://github.com/grpc/grpc-go/blob/master/README.md) first): - -```shell -$ codegen.sh route_guide.proto -``` - -which actually runs: - -```shell -$ protoc --go_out=plugins=grpc:. route_guide.proto -``` - -Running this command generates the following file in your current directory: -- `route_guide.pb.go` - -This contains: -- All the protocol buffer code to populate, serialize, and retrieve our request and response message types -- An interface type (or *stub*) for clients to call with the methods defined in the `RouteGuide` service. -- An interface type for servers to implement, also with the methods defined in the `RouteGuide` service. - - - -## Creating the server - -First let's look at how we create a `RouteGuide` server. If you're only interested in creating gRPC clients, you can skip this section and go straight to [Creating the client](#client) (though you might find it interesting anyway!). - -There are two parts to making our `RouteGuide` service do its job: -- Implementing the service interface generated from our service definition: doing the actual "work" of our service. -- Running a gRPC server to listen for requests from clients and dispatch them to the right service implementation. - -You can find our example `RouteGuide` server in [grpc-go/examples/route_guide/server/server.go](https://github.com/grpc/grpc-go/tree/master/examples/route_guide/server/server.go). Let's take a closer look at how it works. - -### Implementing RouteGuide - -As you can see, our server has a `routeGuideServer` struct type that implements the generated `RouteGuideServer` interface: - -```go -type routeGuideServer struct { - ... -} -... - -func (s *routeGuideServer) GetFeature(ctx context.Context, point *pb.Point) (*pb.Feature, error) { - ... -} -... - -func (s *routeGuideServer) ListFeatures(rect *pb.Rectangle, stream pb.RouteGuide_ListFeaturesServer) error { - ... -} -... - -func (s *routeGuideServer) RecordRoute(stream pb.RouteGuide_RecordRouteServer) error { - ... -} -... - -func (s *routeGuideServer) RouteChat(stream pb.RouteGuide_RouteChatServer) error { - ... -} -... -``` - -#### Simple RPC -`routeGuideServer` implements all our service methods. Let's look at the simplest type first, `GetFeature`, which just gets a `Point` from the client and returns the corresponding feature information from its database in a `Feature`. - -```go -func (s *routeGuideServer) GetFeature(ctx context.Context, point *pb.Point) (*pb.Feature, error) { - for _, feature := range s.savedFeatures { - if proto.Equal(feature.Location, point) { - return feature, nil - } - } - // No feature was found, return an unnamed feature - return &pb.Feature{"", point}, nil -} -``` - -The method is passed a context object for the RPC and the client's `Point` protocol buffer request. It returns a `Feature` protocol buffer object with the response information and an `error`. In the method we populate the `Feature` with the appropriate information, and then `return` it along with an `nil` error to tell gRPC that we've finished dealing with the RPC and that the `Feature` can be returned to the client. - -#### Server-side streaming RPC -Now let's look at one of our streaming RPCs. `ListFeatures` is a server-side streaming RPC, so we need to send back multiple `Feature`s to our client. - -```go -func (s *routeGuideServer) ListFeatures(rect *pb.Rectangle, stream pb.RouteGuide_ListFeaturesServer) error { - for _, feature := range s.savedFeatures { - if inRange(feature.Location, rect) { - if err := stream.Send(feature); err != nil { - return err - } - } - } - return nil -} -``` - -As you can see, instead of getting simple request and response objects in our method parameters, this time we get a request object (the `Rectangle` in which our client wants to find `Feature`s) and a special `RouteGuide_ListFeaturesServer` object to write our responses. - -In the method, we populate as many `Feature` objects as we need to return, writing them to the `RouteGuide_ListFeaturesServer` using its `Send()` method. Finally, as in our simple RPC, we return a `nil` error to tell gRPC that we've finished writing responses. Should any error happen in this call, we return a non-`nil` error; the gRPC layer will translate it into an appropriate RPC status to be sent on the wire. - -#### Client-side streaming RPC -Now let's look at something a little more complicated: the client-side streaming method `RecordRoute`, where we get a stream of `Point`s from the client and return a single `RouteSummary` with information about their trip. As you can see, this time the method doesn't have a request parameter at all. Instead, it gets a `RouteGuide_RecordRouteServer` stream, which the server can use to both read *and* write messages - it can receive client messages using its `Recv()` method and return its single response using its `SendAndClose()` method. - -```go -func (s *routeGuideServer) RecordRoute(stream pb.RouteGuide_RecordRouteServer) error { - var pointCount, featureCount, distance int32 - var lastPoint *pb.Point - startTime := time.Now() - for { - point, err := stream.Recv() - if err == io.EOF { - endTime := time.Now() - return stream.SendAndClose(&pb.RouteSummary{ - PointCount: pointCount, - FeatureCount: featureCount, - Distance: distance, - ElapsedTime: int32(endTime.Sub(startTime).Seconds()), - }) - } - if err != nil { - return err - } - pointCount++ - for _, feature := range s.savedFeatures { - if proto.Equal(feature.Location, point) { - featureCount++ - } - } - if lastPoint != nil { - distance += calcDistance(lastPoint, point) - } - lastPoint = point - } -} -``` - -In the method body we use the `RouteGuide_RecordRouteServer`s `Recv()` method to repeatedly read in our client's requests to a request object (in this case a `Point`) until there are no more messages: the server needs to check the the error returned from `Read()` after each call. If this is `nil`, the stream is still good and it can continue reading; if it's `io.EOF` the message stream has ended and the server can return its `RouteSummary`. If it has any other value, we return the error "as is" so that it'll be translated to an RPC status by the gRPC layer. - -#### Bidirectional streaming RPC -Finally, let's look at our bidirectional streaming RPC `RouteChat()`. - -```go -func (s *routeGuideServer) RouteChat(stream pb.RouteGuide_RouteChatServer) error { - for { - in, err := stream.Recv() - if err == io.EOF { - return nil - } - if err != nil { - return err - } - key := serialize(in.Location) - ... // look for notes to be sent to client - for _, note := range s.routeNotes[key] { - if err := stream.Send(note); err != nil { - return err - } - } - } -} -``` - -This time we get a `RouteGuide_RouteChatServer` stream that, as in our client-side streaming example, can be used to read and write messages. However, this time we return values via our method's stream while the client is still writing messages to *their* message stream. - -The syntax for reading and writing here is very similar to our client-streaming method, except the server uses the stream's `Send()` method rather than `SendAndClose()` because it's writing multiple responses. Although each side will always get the other's messages in the order they were written, both the client and server can read and write in any order — the streams operate completely independently. - -### Starting the server - -Once we've implemented all our methods, we also need to start up a gRPC server so that clients can actually use our service. The following snippet shows how we do this for our `RouteGuide` service: - -```go -flag.Parse() -lis, err := net.Listen("tcp", fmt.Sprintf(":%d", *port)) -if err != nil { - log.Fatalf("failed to listen: %v", err) -} -grpcServer := grpc.NewServer() -pb.RegisterRouteGuideServer(grpcServer, &routeGuideServer{}) -... // determine whether to use TLS -grpcServer.Serve(lis) -``` -To build and start a server, we: - -1. Specify the port we want to use to listen for client requests using `lis, err := net.Listen("tcp", fmt.Sprintf(":%d", *port))`. -2. Create an instance of the gRPC server using `grpc.NewServer()`. -3. Register our service implementation with the gRPC server. -4. Call `Serve()` on the server with our port details to do a blocking wait until the process is killed or `Stop()` is called. - - -## Creating the client - -In this section, we'll look at creating a Go client for our `RouteGuide` service. You can see our complete example client code in [grpc-go/examples/route_guide/client/client.go](https://github.com/grpc/grpc-go/tree/master/examples/route_guide/client/client.go). - -### Creating a stub - -To call service methods, we first need to create a gRPC *channel* to communicate with the server. We create this by passing the server address and port number to `grpc.Dial()` as follows: - -```go -conn, err := grpc.Dial(*serverAddr) -if err != nil { - ... -} -defer conn.Close() -``` - -You can use `DialOptions` to set the auth credentials (e.g., TLS, GCE credentials, JWT credentials) in `grpc.Dial` if the service you request requires that - however, we don't need to do this for our `RouteGuide` service. - -Once the gRPC *channel* is setup, we need a client *stub* to perform RPCs. We get this using the `NewRouteGuideClient` method provided in the `pb` package we generated from our .proto. - -```go -client := pb.NewRouteGuideClient(conn) -``` - -### Calling service methods - -Now let's look at how we call our service methods. Note that in gRPC-Go, RPCs operate in a blocking/synchronous mode, which means that the RPC call waits for the server to respond, and will either return a response or an error. - -#### Simple RPC - -Calling the simple RPC `GetFeature` is nearly as straightforward as calling a local method. - -```go -feature, err := client.GetFeature(context.Background(), &pb.Point{409146138, -746188906}) -if err != nil { - ... -} -``` - -As you can see, we call the method on the stub we got earlier. In our method parameters we create and populate a request protocol buffer object (in our case `Point`). We also pass a `context.Context` object which lets us change our RPC's behaviour if necessary, such as time-out/cancel an RPC in flight. If the call doesn't return an error, then we can read the response information from the server from the first return value. - -```go -log.Println(feature) -``` - -#### Server-side streaming RPC - -Here's where we call the server-side streaming method `ListFeatures`, which returns a stream of geographical `Feature`s. If you've already read [Creating the server](#server) some of this may look very familiar - streaming RPCs are implemented in a similar way on both sides. - -```go -rect := &pb.Rectangle{ ... } // initialize a pb.Rectangle -stream, err := client.ListFeatures(context.Background(), rect) -if err != nil { - ... -} -for { - feature, err := stream.Recv() - if err == io.EOF { - break - } - if err != nil { - log.Fatalf("%v.ListFeatures(_) = _, %v", client, err) - } - log.Println(feature) -} -``` - -As in the simple RPC, we pass the method a context and a request. However, instead of getting a response object back, we get back an instance of `RouteGuide_ListFeaturesClient`. The client can use the `RouteGuide_ListFeaturesClient` stream to read the server's responses. - -We use the `RouteGuide_ListFeaturesClient`'s `Recv()` method to repeatedly read in the server's responses to a response protocol buffer object (in this case a `Feature`) until there are no more messages: the client needs to check the error `err` returned from `Recv()` after each call. If `nil`, the stream is still good and it can continue reading; if it's `io.EOF` then the message stream has ended; otherwise there must be an RPC error, which is passed over through `err`. - -#### Client-side streaming RPC - -The client-side streaming method `RecordRoute` is similar to the server-side method, except that we only pass the method a context and get a `RouteGuide_RecordRouteClient` stream back, which we can use to both write *and* read messages. - -```go -// Create a random number of random points -r := rand.New(rand.NewSource(time.Now().UnixNano())) -pointCount := int(r.Int31n(100)) + 2 // Traverse at least two points -var points []*pb.Point -for i := 0; i < pointCount; i++ { - points = append(points, randomPoint(r)) -} -log.Printf("Traversing %d points.", len(points)) -stream, err := client.RecordRoute(context.Background()) -if err != nil { - log.Fatalf("%v.RecordRoute(_) = _, %v", client, err) -} -for _, point := range points { - if err := stream.Send(point); err != nil { - log.Fatalf("%v.Send(%v) = %v", stream, point, err) - } -} -reply, err := stream.CloseAndRecv() -if err != nil { - log.Fatalf("%v.CloseAndRecv() got error %v, want %v", stream, err, nil) -} -log.Printf("Route summary: %v", reply) -``` - -The `RouteGuide_RecordRouteClient` has a `Send()` method that we can use to send requests to the server. Once we've finished writing our client's requests to the stream using `Send()`, we need to call `CloseAndRecv()` on the stream to let gRPC know that we've finished writing and are expecting to receive a response. We get our RPC status from the `err` returned from `CloseAndRecv()`. If the status is `nil`, then the first return value from `CloseAndRecv()` will be a valid server response. - -#### Bidirectional streaming RPC - -Finally, let's look at our bidirectional streaming RPC `RouteChat()`. As in the case of `RecordRoute`, we only pass the method a context object and get back a stream that we can use to both write and read messages. However, this time we return values via our method's stream while the server is still writing messages to *their* message stream. - -```go -stream, err := client.RouteChat(context.Background()) -waitc := make(chan struct{}) -go func() { - for { - in, err := stream.Recv() - if err == io.EOF { - // read done. - close(waitc) - return - } - if err != nil { - log.Fatalf("Failed to receive a note : %v", err) - } - log.Printf("Got message %s at point(%d, %d)", in.Message, in.Location.Latitude, in.Location.Longitude) - } -}() -for _, note := range notes { - if err := stream.Send(note); err != nil { - log.Fatalf("Failed to send a note: %v", err) - } -} -stream.CloseSend() -<-waitc -``` - -The syntax for reading and writing here is very similar to our client-side streaming method, except we use the stream's `CloseSend()` method once we've finished our call. Although each side will always get the other's messages in the order they were written, both the client and server can read and write in any order — the streams operate completely independently. - -## Try it out! - -To compile and run the server, assuming you are in the folder -`$GOPATH/src/google.golang.org/grpc/examples/route_guide`, simply: - -```sh -$ go run server/server.go -``` - -Likewise, to run the client: - -```sh -$ go run client/client.go -``` - diff --git a/grpc-common/go/greeter_client/main.go b/grpc-common/go/greeter_client/main.go deleted file mode 100644 index 065ae852bc3..00000000000 --- a/grpc-common/go/greeter_client/main.go +++ /dev/null @@ -1,69 +0,0 @@ -/* - * - * Copyright 2015, 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. - * - */ - -package main - -import ( - "log" - "os" - - pb "github.com/grpc/grpc-common/go/helloworld" - "golang.org/x/net/context" - "google.golang.org/grpc" -) - -const ( - address = "localhost:50051" - defaultName = "world" -) - -func main() { - // Set up a connection to the server. - conn, err := grpc.Dial(address) - if err != nil { - log.Fatalf("did not connect: %v", err) - } - defer conn.Close() - c := pb.NewGreeterClient(conn) - - // Contact the server and print out its response. - name := defaultName - if len(os.Args) > 1 { - name = os.Args[1] - } - r, err := c.SayHello(context.Background(), &pb.HelloRequest{Name: name}) - if err != nil { - log.Fatalf("could not greet: %v", err) - } - log.Printf("Greeting: %s", r.Message) -} diff --git a/grpc-common/go/greeter_server/main.go b/grpc-common/go/greeter_server/main.go deleted file mode 100644 index c7fa06ad180..00000000000 --- a/grpc-common/go/greeter_server/main.go +++ /dev/null @@ -1,65 +0,0 @@ -/* - * - * Copyright 2015, 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. - * - */ - -package main - -import ( - "log" - "net" - - pb "github.com/grpc/grpc-common/go/helloworld" - "golang.org/x/net/context" - "google.golang.org/grpc" -) - -const ( - port = ":50051" -) - -// server is used to implement hellowrld.GreeterServer. -type server struct{} - -// SayHello implements helloworld.GreeterServer -func (s *server) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) { - return &pb.HelloReply{Message: "Hello " + in.Name}, nil -} - -func main() { - lis, err := net.Listen("tcp", port) - if err != nil { - log.Fatalf("failed to listen: %v", err) - } - s := grpc.NewServer() - pb.RegisterGreeterServer(s, &server{}) - s.Serve(lis) -} diff --git a/grpc-common/go/helloworld/helloworld.pb.go b/grpc-common/go/helloworld/helloworld.pb.go deleted file mode 100644 index 1ff931a3844..00000000000 --- a/grpc-common/go/helloworld/helloworld.pb.go +++ /dev/null @@ -1,109 +0,0 @@ -// Code generated by protoc-gen-go. -// source: helloworld.proto -// DO NOT EDIT! - -/* -Package helloworld is a generated protocol buffer package. - -It is generated from these files: - helloworld.proto - -It has these top-level messages: - HelloRequest - HelloReply -*/ -package helloworld - -import proto "github.com/golang/protobuf/proto" - -import ( - context "golang.org/x/net/context" - grpc "google.golang.org/grpc" -) - -// Reference imports to suppress errors if they are not otherwise used. -var _ context.Context -var _ grpc.ClientConn - -// Reference imports to suppress errors if they are not otherwise used. -var _ = proto.Marshal - -// The request message containing the user's name. -type HelloRequest struct { - Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"` -} - -func (m *HelloRequest) Reset() { *m = HelloRequest{} } -func (m *HelloRequest) String() string { return proto.CompactTextString(m) } -func (*HelloRequest) ProtoMessage() {} - -// The response message containing the greetings -type HelloReply struct { - Message string `protobuf:"bytes,1,opt,name=message" json:"message,omitempty"` -} - -func (m *HelloReply) Reset() { *m = HelloReply{} } -func (m *HelloReply) String() string { return proto.CompactTextString(m) } -func (*HelloReply) ProtoMessage() {} - -func init() { -} - -// Client API for Greeter service - -type GreeterClient interface { - // Sends a greeting - SayHello(ctx context.Context, in *HelloRequest, opts ...grpc.CallOption) (*HelloReply, error) -} - -type greeterClient struct { - cc *grpc.ClientConn -} - -func NewGreeterClient(cc *grpc.ClientConn) GreeterClient { - return &greeterClient{cc} -} - -func (c *greeterClient) SayHello(ctx context.Context, in *HelloRequest, opts ...grpc.CallOption) (*HelloReply, error) { - out := new(HelloReply) - err := grpc.Invoke(ctx, "/helloworld.Greeter/SayHello", in, out, c.cc, opts...) - if err != nil { - return nil, err - } - return out, nil -} - -// Server API for Greeter service - -type GreeterServer interface { - // Sends a greeting - SayHello(context.Context, *HelloRequest) (*HelloReply, error) -} - -func RegisterGreeterServer(s *grpc.Server, srv GreeterServer) { - s.RegisterService(&_Greeter_serviceDesc, srv) -} - -func _Greeter_SayHello_Handler(srv interface{}, ctx context.Context, codec grpc.Codec, buf []byte) (interface{}, error) { - in := new(HelloRequest) - if err := codec.Unmarshal(buf, in); err != nil { - return nil, err - } - out, err := srv.(GreeterServer).SayHello(ctx, in) - if err != nil { - return nil, err - } - return out, nil -} - -var _Greeter_serviceDesc = grpc.ServiceDesc{ - ServiceName: "helloworld.Greeter", - HandlerType: (*GreeterServer)(nil), - Methods: []grpc.MethodDesc{ - { - MethodName: "SayHello", - Handler: _Greeter_SayHello_Handler, - }, - }, - Streams: []grpc.StreamDesc{}, -} diff --git a/grpc-common/java/android/.gitignore b/grpc-common/java/android/.gitignore deleted file mode 100644 index 6345b76a48c..00000000000 --- a/grpc-common/java/android/.gitignore +++ /dev/null @@ -1,21 +0,0 @@ -.gradle -/local.properties -/gradle.properties -/.idea/workspace.xml -/.idea/libraries -.DS_Store -/build -.idea/ - -*.iml -*.apk -*.ap_ -*.dex -*.class -bin/ -gen/ -.gradle/ -/*/build/ -local.properties -proguard/ -*.log diff --git a/grpc-common/java/android/README.md b/grpc-common/java/android/README.md deleted file mode 100644 index 9de65a0267f..00000000000 --- a/grpc-common/java/android/README.md +++ /dev/null @@ -1,41 +0,0 @@ -gRPC Hello World Tutorial (Android Java) -======================== - -BACKGROUND -------------- -For this sample, we've already generated the server and client stubs from [helloworld.proto](https://github.com/grpc/grpc-common/blob/master/protos/helloworld.proto). - -PREREQUISITES -------------- -- [Java gRPC](https://github.com/grpc/grpc-java) - -- [Android Tutorial](https://developer.android.com/training/basics/firstapp/index.html) if you're new to Android development - -- We only have Android gRPC client in this example. Please follow examples in other languages to build and run a gRPC server. - -INSTALL -------- -**1 Clone the gRPC Java git repo** -```sh -$ git clone https://github.com/grpc/grpc-java -``` - -**2 Install gRPC Java, as described in [How to Build](https://github.com/grpc/grpc-java#how-to-build)** -```sh -$ # from this dir -$ cd grpc-java -$ # follow the instructions in 'How to Build' -``` - -**3 Prepare the app** -- Clone this git repo -```sh -$ git clone https://github.com/grpc/grpc-common - -``` - -**4 Install the app** -```sh -$ cd grpc-common/java/android -$ ./gradlew installDebug -``` diff --git a/grpc-common/java/android/app/.gitignore b/grpc-common/java/android/app/.gitignore deleted file mode 100644 index 796b96d1c40..00000000000 --- a/grpc-common/java/android/app/.gitignore +++ /dev/null @@ -1 +0,0 @@ -/build diff --git a/grpc-common/java/android/app/build.gradle b/grpc-common/java/android/app/build.gradle deleted file mode 100644 index aedf4fe92a0..00000000000 --- a/grpc-common/java/android/app/build.gradle +++ /dev/null @@ -1,34 +0,0 @@ -apply plugin: 'com.android.application' - -android { - compileSdkVersion 21 - buildToolsVersion "21.1.2" - - defaultConfig { - applicationId "io.grpc.helloworldexample" - minSdkVersion 7 - targetSdkVersion 21 - versionCode 1 - versionName "1.0" - } - buildTypes { - release { - minifyEnabled false - proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' - } - } -} - -dependencies { - compile 'com.android.support:appcompat-v7:21.0.3' - compile 'com.google.code.findbugs:jsr305:3.0.0' - compile 'com.squareup.okhttp:okhttp:2.2.0' - compile 'com.google.guava:guava:18.0' - - // You need to build the https://github.com/grpc/grpc-java - // to obtain these libraries below. - compile 'io.grpc:grpc-core:0.1.0-SNAPSHOT' - compile 'io.grpc:grpc-protobuf-nano:0.1.0-SNAPSHOT' - compile 'io.grpc:grpc-okhttp:0.1.0-SNAPSHOT' - compile 'io.grpc:grpc-stub:0.1.0-SNAPSHOT' -} diff --git a/grpc-common/java/android/app/proguard-rules.pro b/grpc-common/java/android/app/proguard-rules.pro deleted file mode 100644 index 3e659b91f38..00000000000 --- a/grpc-common/java/android/app/proguard-rules.pro +++ /dev/null @@ -1,17 +0,0 @@ -# Add project specific ProGuard rules here. -# By default, the flags in this file are appended to flags specified -# in /Users/thagikura/android-sdk/tools/proguard/proguard-android.txt -# You can edit the include path and order by changing the proguardFiles -# directive in build.gradle. -# -# For more details, see -# http://developer.android.com/guide/developing/tools/proguard.html - -# Add any project specific keep options here: - -# If your project uses WebView with JS, uncomment the following -# and specify the fully qualified class name to the JavaScript interface -# class: -#-keepclassmembers class fqcn.of.javascript.interface.for.webview { -# public *; -#} diff --git a/grpc-common/java/android/app/src/main/AndroidManifest.xml b/grpc-common/java/android/app/src/main/AndroidManifest.xml deleted file mode 100644 index 8c40f11684d..00000000000 --- a/grpc-common/java/android/app/src/main/AndroidManifest.xml +++ /dev/null @@ -1,22 +0,0 @@ - - - - - - - - - - - - - - - diff --git a/grpc-common/java/android/app/src/main/java/io/grpc/helloworldexample/GreeterGrpc.java b/grpc-common/java/android/app/src/main/java/io/grpc/helloworldexample/GreeterGrpc.java deleted file mode 100644 index 817c9fde8fc..00000000000 --- a/grpc-common/java/android/app/src/main/java/io/grpc/helloworldexample/GreeterGrpc.java +++ /dev/null @@ -1,179 +0,0 @@ -package io.grpc.helloworldexample; - -import java.io.IOException; - -import static io.grpc.stub.Calls.asyncUnaryCall; -import static io.grpc.stub.Calls.blockingUnaryCall; -import static io.grpc.stub.Calls.createMethodDescriptor; -import static io.grpc.stub.Calls.unaryFutureCall; -import static io.grpc.stub.ServerCalls.asyncUnaryRequestCall; -import static io.grpc.stub.ServerCalls.createMethodDefinition; - -public class GreeterGrpc { - - private static final io.grpc.stub.Method METHOD_SAY_HELLO = - io.grpc.stub.Method.create( - io.grpc.MethodType.UNARY, "SayHello", - io.grpc.protobuf.nano.NanoUtils.marshaller( - new io.grpc.protobuf.nano.Parser() { - @Override - public Helloworld.HelloRequest parse(com.google.protobuf.nano.CodedInputByteBufferNano input) throws IOException { - return Helloworld.HelloRequest.parseFrom(input); - } - }), - io.grpc.protobuf.nano.NanoUtils.marshaller( - new io.grpc.protobuf.nano.Parser() { - @Override - public Helloworld.HelloReply parse(com.google.protobuf.nano.CodedInputByteBufferNano input) throws IOException { - return Helloworld.HelloReply.parseFrom(input); - } - })); - - public static GreeterStub newStub(io.grpc.Channel channel) { - return new GreeterStub(channel, CONFIG); - } - - public static GreeterBlockingStub newBlockingStub( - io.grpc.Channel channel) { - return new GreeterBlockingStub(channel, CONFIG); - } - - public static GreeterFutureStub newFutureStub( - io.grpc.Channel channel) { - return new GreeterFutureStub(channel, CONFIG); - } - - public static final GreeterServiceDescriptor CONFIG = - new GreeterServiceDescriptor(); - - public static class GreeterServiceDescriptor extends - io.grpc.stub.AbstractServiceDescriptor { - public final io.grpc.MethodDescriptor sayHello; - - private GreeterServiceDescriptor() { - sayHello = createMethodDescriptor( - "helloworld.Greeter", METHOD_SAY_HELLO); - } - - private GreeterServiceDescriptor( - java.util.Map> methodMap) { - sayHello = (io.grpc.MethodDescriptor) methodMap.get( - CONFIG.sayHello.getName()); - } - - @java.lang.Override - protected GreeterServiceDescriptor build( - java.util.Map> methodMap) { - return new GreeterServiceDescriptor(methodMap); - } - - @java.lang.Override - public com.google.common.collect.ImmutableList> methods() { - return com.google.common.collect.ImmutableList.>of( - sayHello); - } - } - - public static interface Greeter { - - public void sayHello(Helloworld.HelloRequest request, - io.grpc.stub.StreamObserver responseObserver); - } - - public static interface GreeterBlockingClient { - - public Helloworld.HelloReply sayHello(Helloworld.HelloRequest request); - } - - public static interface GreeterFutureClient { - - public com.google.common.util.concurrent.ListenableFuture sayHello( - Helloworld.HelloRequest request); - } - - public static class GreeterStub extends - io.grpc.stub.AbstractStub - implements Greeter { - private GreeterStub(io.grpc.Channel channel, - GreeterServiceDescriptor config) { - super(channel, config); - } - - @java.lang.Override - protected GreeterStub build(io.grpc.Channel channel, - GreeterServiceDescriptor config) { - return new GreeterStub(channel, config); - } - - @java.lang.Override - public void sayHello(Helloworld.HelloRequest request, - io.grpc.stub.StreamObserver responseObserver) { - asyncUnaryCall( - channel.newCall(config.sayHello), request, responseObserver); - } - } - - public static class GreeterBlockingStub extends - io.grpc.stub.AbstractStub - implements GreeterBlockingClient { - private GreeterBlockingStub(io.grpc.Channel channel, - GreeterServiceDescriptor config) { - super(channel, config); - } - - @java.lang.Override - protected GreeterBlockingStub build(io.grpc.Channel channel, - GreeterServiceDescriptor config) { - return new GreeterBlockingStub(channel, config); - } - - @java.lang.Override - public Helloworld.HelloReply sayHello(Helloworld.HelloRequest request) { - return blockingUnaryCall( - channel.newCall(config.sayHello), request); - } - } - - public static class GreeterFutureStub extends - io.grpc.stub.AbstractStub - implements GreeterFutureClient { - private GreeterFutureStub(io.grpc.Channel channel, - GreeterServiceDescriptor config) { - super(channel, config); - } - - @java.lang.Override - protected GreeterFutureStub build(io.grpc.Channel channel, - GreeterServiceDescriptor config) { - return new GreeterFutureStub(channel, config); - } - - @java.lang.Override - public com.google.common.util.concurrent.ListenableFuture sayHello( - Helloworld.HelloRequest request) { - return unaryFutureCall( - channel.newCall(config.sayHello), request); - } - } - - public static io.grpc.ServerServiceDefinition bindService( - final Greeter serviceImpl) { - return io.grpc.ServerServiceDefinition.builder("helloworld.Greeter") - .addMethod(createMethodDefinition( - METHOD_SAY_HELLO, - asyncUnaryRequestCall( - new io.grpc.stub.ServerCalls.UnaryRequestMethod< - Helloworld.HelloRequest, - Helloworld.HelloReply>() { - @java.lang.Override - public void invoke( - Helloworld.HelloRequest request, - io.grpc.stub.StreamObserver responseObserver) { - serviceImpl.sayHello(request, responseObserver); - } - }))).build(); - } -} diff --git a/grpc-common/java/android/app/src/main/java/io/grpc/helloworldexample/Helloworld.java b/grpc-common/java/android/app/src/main/java/io/grpc/helloworldexample/Helloworld.java deleted file mode 100644 index 28da5a91d3e..00000000000 --- a/grpc-common/java/android/app/src/main/java/io/grpc/helloworldexample/Helloworld.java +++ /dev/null @@ -1,175 +0,0 @@ -// Generated by the protocol buffer compiler. DO NOT EDIT! - -package io.grpc.helloworldexample; - -@SuppressWarnings("hiding") -public interface Helloworld { - - public static final class HelloRequest extends - com.google.protobuf.nano.MessageNano { - - private static volatile HelloRequest[] _emptyArray; - public static HelloRequest[] emptyArray() { - // Lazily initializes the empty array - if (_emptyArray == null) { - synchronized ( - com.google.protobuf.nano.InternalNano.LAZY_INIT_LOCK) { - if (_emptyArray == null) { - _emptyArray = new HelloRequest[0]; - } - } - } - return _emptyArray; - } - - // optional string name = 1; - public java.lang.String name; - - public HelloRequest() { - clear(); - } - - public HelloRequest clear() { - name = ""; - cachedSize = -1; - return this; - } - - @Override - public void writeTo(com.google.protobuf.nano.CodedOutputByteBufferNano output) - throws java.io.IOException { - if (!this.name.equals("")) { - output.writeString(1, this.name); - } - super.writeTo(output); - } - - @Override - protected int computeSerializedSize() { - int size = super.computeSerializedSize(); - if (!this.name.equals("")) { - size += com.google.protobuf.nano.CodedOutputByteBufferNano - .computeStringSize(1, this.name); - } - return size; - } - - @Override - public HelloRequest mergeFrom( - com.google.protobuf.nano.CodedInputByteBufferNano input) - throws java.io.IOException { - while (true) { - int tag = input.readTag(); - switch (tag) { - case 0: - return this; - default: { - if (!com.google.protobuf.nano.WireFormatNano.parseUnknownField(input, tag)) { - return this; - } - break; - } - case 10: { - this.name = input.readString(); - break; - } - } - } - } - - public static HelloRequest parseFrom(byte[] data) - throws com.google.protobuf.nano.InvalidProtocolBufferNanoException { - return com.google.protobuf.nano.MessageNano.mergeFrom(new HelloRequest(), data); - } - - public static HelloRequest parseFrom( - com.google.protobuf.nano.CodedInputByteBufferNano input) - throws java.io.IOException { - return new HelloRequest().mergeFrom(input); - } - } - - public static final class HelloReply extends - com.google.protobuf.nano.MessageNano { - - private static volatile HelloReply[] _emptyArray; - public static HelloReply[] emptyArray() { - // Lazily initializes the empty array - if (_emptyArray == null) { - synchronized ( - com.google.protobuf.nano.InternalNano.LAZY_INIT_LOCK) { - if (_emptyArray == null) { - _emptyArray = new HelloReply[0]; - } - } - } - return _emptyArray; - } - - // optional string message = 1; - public java.lang.String message; - - public HelloReply() { - clear(); - } - - public HelloReply clear() { - message = ""; - cachedSize = -1; - return this; - } - - @Override - public void writeTo(com.google.protobuf.nano.CodedOutputByteBufferNano output) - throws java.io.IOException { - if (!this.message.equals("")) { - output.writeString(1, this.message); - } - super.writeTo(output); - } - - @Override - protected int computeSerializedSize() { - int size = super.computeSerializedSize(); - if (!this.message.equals("")) { - size += com.google.protobuf.nano.CodedOutputByteBufferNano - .computeStringSize(1, this.message); - } - return size; - } - - @Override - public HelloReply mergeFrom( - com.google.protobuf.nano.CodedInputByteBufferNano input) - throws java.io.IOException { - while (true) { - int tag = input.readTag(); - switch (tag) { - case 0: - return this; - default: { - if (!com.google.protobuf.nano.WireFormatNano.parseUnknownField(input, tag)) { - return this; - } - break; - } - case 10: { - this.message = input.readString(); - break; - } - } - } - } - - public static HelloReply parseFrom(byte[] data) - throws com.google.protobuf.nano.InvalidProtocolBufferNanoException { - return com.google.protobuf.nano.MessageNano.mergeFrom(new HelloReply(), data); - } - - public static HelloReply parseFrom( - com.google.protobuf.nano.CodedInputByteBufferNano input) - throws java.io.IOException { - return new HelloReply().mergeFrom(input); - } - } -} \ No newline at end of file diff --git a/grpc-common/java/android/app/src/main/java/io/grpc/helloworldexample/HelloworldActivity.java b/grpc-common/java/android/app/src/main/java/io/grpc/helloworldexample/HelloworldActivity.java deleted file mode 100644 index b6d734f9a9b..00000000000 --- a/grpc-common/java/android/app/src/main/java/io/grpc/helloworldexample/HelloworldActivity.java +++ /dev/null @@ -1,90 +0,0 @@ -package io.grpc.helloworldexample; - -import android.content.Context; -import android.os.AsyncTask; -import android.os.Bundle; -import android.support.v7.app.ActionBarActivity; -import android.text.TextUtils; -import android.view.View; -import android.view.inputmethod.InputMethodManager; -import android.widget.Button; -import android.widget.EditText; -import android.widget.TextView; - -import java.util.concurrent.TimeUnit; - -import io.grpc.ChannelImpl; -import io.grpc.helloworldexample.Helloworld.HelloReply; -import io.grpc.helloworldexample.Helloworld.HelloRequest; -import io.grpc.transport.okhttp.OkHttpChannelBuilder; - -public class HelloworldActivity extends ActionBarActivity { - private Button mSendButton; - private EditText mHostEdit; - private EditText mPortEdit; - private EditText mMessageEdit; - private TextView mResultText; - - @Override - protected void onCreate(Bundle savedInstanceState) { - super.onCreate(savedInstanceState); - setContentView(R.layout.activity_helloworld); - mSendButton = (Button) findViewById(R.id.send_button); - mHostEdit = (EditText) findViewById(R.id.host_edit_text); - mPortEdit = (EditText) findViewById(R.id.port_edit_text); - mMessageEdit = (EditText) findViewById(R.id.message_edit_text); - mResultText = (TextView) findViewById(R.id.grpc_response_text); - } - - public void sendMessage(View view) { - ((InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE)) - .hideSoftInputFromWindow(mHostEdit.getWindowToken(), 0); - mSendButton.setEnabled(false); - new GrpcTask().execute(); - } - - private class GrpcTask extends AsyncTask { - private String mHost; - private String mMessage; - private int mPort; - private ChannelImpl mChannel; - - @Override - protected void onPreExecute() { - mHost = mHostEdit.getText().toString(); - mMessage = mMessageEdit.getText().toString(); - String portStr = mPortEdit.getText().toString(); - mPort = TextUtils.isEmpty(portStr) ? 0 : Integer.valueOf(portStr); - mResultText.setText(""); - } - - private String sayHello(ChannelImpl channel) { - GreeterGrpc.GreeterBlockingStub stub = GreeterGrpc.newBlockingStub(channel); - HelloRequest message = new HelloRequest(); - message.name = mMessage; - HelloReply reply = stub.sayHello(message); - return reply.message; - } - - @Override - protected String doInBackground(Void... nothing) { - try { - mChannel = OkHttpChannelBuilder.forAddress(mHost, mPort).build(); - return sayHello(mChannel); - } catch (Exception e) { - return "Failed... : " + e.getMessage(); - } - } - - @Override - protected void onPostExecute(String result) { - try { - mChannel.shutdown().awaitTerminated(1, TimeUnit.SECONDS); - } catch (InterruptedException e) { - Thread.currentThread().interrupt(); - } - mResultText.setText(result); - mSendButton.setEnabled(true); - } - } -} \ No newline at end of file diff --git a/grpc-common/java/android/app/src/main/res/layout/activity_helloworld.xml b/grpc-common/java/android/app/src/main/res/layout/activity_helloworld.xml deleted file mode 100644 index 00ca04ce656..00000000000 --- a/grpc-common/java/android/app/src/main/res/layout/activity_helloworld.xml +++ /dev/null @@ -1,54 +0,0 @@ - - - - - - - - - - -