Contents -------- This folder contains three kinds of file: - Code, such as ProtoBench.java, to build the benchmarking framework. - Protocol buffer definitions (.proto files) - Sample data files If we end up with a lot of different benchmarks it may be worth separating these out info different directories, but while there are so few they might as well all be together. Running a benchmark (Java) -------------------------- 1) Build protoc and the Java protocol buffer library. The examples below assume a jar file (protobuf.jar) has been built and copied into this directory. 2) Build ProtoBench: $ javac -d tmp -cp protobuf.jar ProtoBench.java 3) Generate code for the relevant benchmark protocol buffer, e.g. $ protoc --java_out=tmp google_size.proto 4) Build the generated code, e.g. $ javac -d tmp -cp protobuf.jar tmp/benchmarks/*.java 5) Run the test. Arguments are given in pairs - the first argument is the descriptor type; the second is the filename. For example: $ java -cp tmp:protobuf.jar com.google.protocolbuffers.ProtoBench \ 'benchmarks.GoogleSize$SizeMessage1' google_message1.dat \ 'benchmarks.GoogleSize$SizeMessage2' google_message2.dat 6) Wait! Each test runs for around 30 seconds, and there are 8 tests per class/data combination. The above command would therefore take about 8 minutes to run. Benchmarks available -------------------- From Google: google_size.proto, messages google_message1.dat and google_message2.dat.