1. Rockin' Protobuf in Ruby BJ Neilsen rand9.com bj.neilsen@gmail.com

2. Definitions & Ideas

4. 48,162 defined message types

5. 12,183 .proto files

6. Fills three specific needs:Type Definition & Versioning Data Serialization Client/Server interchange (RPC)

8. Supported field types:

9. double, float, string, integer, boolean, bytes, composite (Message, Enum)

10. Field requirements:

11. required, optional, repeated (opt)

13. Multiple fields, tagged numerically

14. Field tags shouldn't change once in use.*message User { required string guid = 1; optional string first_name = 2; optional string last_name = 3; repeated Friend friends = 4; optional int64 date_created = 5; optional bool is_active = 6 [default=false]; } * Unless you are brave

16. Useful for types and statusesenum StatusType { PENDING = 0; ENABLED = 1; DISABLED = 2; DELETED = 3; } message User { # ... optional StatusType status = 7 [default=PENDING]; }

18. "Procedure" = name + request + response

19. Generated stubs, implementation still necessary.service UserService { rpc Find (UserFindRequest) returns (UserList); rpc Create (User) returns (User); rpc Update (User) returns (User); rpc Delete (User) returns (User); }

20. Compilation $ gem install protobuffy $ cd myapp $ rprotoc proto/user.proto -o lib/ $ ls lib user.pb.rb user_service.rb

22. Can (should) run independent of your unciorn/thin processes

23. Register services by requiring them (app/services/*.rb)# file: lib/pb_server.rb require 'protobuf/rpc/server' require 'app/services/user_service' include Protobuf EM::run { EM::start_server('localhost', 9933, Rpc::Server) }

25. RPC endpoints -> instance methods

26. Request/response as implicit objects

27. Pre/post serialization for free

28. Response helpers:

29. rpc_failed(String or Exception)

30. self.response=(Object)

31. self.async_responder(boolean)

34. AJAX-style response callbacks

35. Pre/post serialization for freerequest = UserFindRequest.new request.name = 'jeff' UserService.client.find(request) do |c| c.on_failure do |e| logger.error('%s (%s)' % [e.message, e.code]) end c.on_success do |res| # res is a UserList object # handle successful response end end

36. Examples