1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
---
title: "Finagle with scala-bootstrapper"
date: 2012-01-25T09:45:00Z
comments: false
url: /finagle-with-scala-bootstrapper
tags: ["scala"]
---
I've been fascinated by the concepts in [finagle](http://twitter.github.com/finagle/) for some time, but being a scala noob, I never knew how to bootstrap a finagle project. Turns out twitter has a gem, [scala-bootstrapper](https://github.com/twitter/scala-bootstrapper), that generates a simple thirft based key/value store for you. There's even a[tutorial](http://twitter.github.com/scala_school/searchbird.html) on how to extend the example project into a distributed search service.
This is a guide on setting it all up locally, it assumes you have Git, Homebrew, and OS X.
### Install scala 2.8.1
```sh
$ brew versions scala
$ cd/usr/local/(or wherever you have homebrew installed)
$ git checkout -b scala281 0e16b9d(make sure the SHA matches versions output)
$ brew install scala
$ git checkout master$git branch -D scala281
```
### Install sbt 0.7.4 (assumes you have a ~/bin in your $PATH)
```sh
$ curl -O http://simple-build-tool.googlecode.com/files/sbt-launch-0.7.4.jar > ~/bin/sbt-launch.jar
$ echo 'java -Xmx1G -jar `dirname $0`/sbt-launch.jar "$@"'> ~/bin/sbt
```
### Install scala-bootstrapper
```sh
$ gem install scala-bootstrapper
```
### Generate finagle project**
```sh
$ mkdir newbird
$ cd newbird
$ scala-bootstrapper newbird
$ sbt update
$ sbt test
```
### Add a Client class
create newbird/src/main/scala/com/twitter/newbird/Client.scala with
```scala
package com.twitter.newbird
import com.twitter.finagle.builder.ClientBuilder
import com.twitter.finagle.thrift.ThriftClientFramedCodec
import com.twitter.newbird.thrift._
import org.apache.thrift.protocol.TBinaryProtocol
import java.net.InetSocketAddress
class Client {
val service = ClientBuilder().hosts(Seq(newInetSocketAddress("localhost",9999)))
.codec(ThriftClientFramedCodec())
.hostConnectionLimit(1)
.build()
val client = new NewbirdServiceClientAdapter(
new thrift.NewbirdService.ServiceToClient(service,newTBinaryProtocol.Factory))
def get(key:String) = client.get(key)()
def put(key:String, value:String) = client.put(key,value)()
}
```
### Running the server
```sh
$ cd newbird
$ sbt> run -f config/development.scala
```
### Playing with the client
```sh
$ cd newbird
$ sbt console
scala> import com.twitter.newbird.Client
scala> val client = new Client()
scala> client.put("foo","bar")
scala> client.get("foo")
```
### Bonus
finagle exports a stats url you can curl:
```sh
$ curl http://localhost:9900/stats.txt
counters: Newbird/connects: 1
Newbird/requests: 4
Newbird/success: 4
gauges:
Newbird/connections: 0
Newbird/pending: 0
jvm_heap_committed: 588251136
jvm_heap_max: 2146828288
jvm_heap_used: 64354560
jvm_nonheap_committed: 83267584
jvm_nonheap_max: 318767104
jvm_nonheap_used: 68655360
jvm_num_cpus: 4
jvm_start_time: 1327511164928
jvm_thread_count: 14
jvm_thread_daemon_count: 9
jvm_thread_peak_count: 14
jvm_uptime: 2626505
labels:
metrics:
Newbird/connection_duration: (average=2590412, count=1, maximum=2590412, minimum=2590412, p25=2590412, p50=2590412, p75=2590412, p90=2590412, p99=2590412, p999=2590412, p9999=2590412)
Newbird/connection_received_bytes: (average=192, count=1, maximum=192, minimum=192, p25=192, p50=192, p75=192, p90=192, p99=192, p999=192, p9999=192)
Newbird/connection_requests: (average=4, count=1, maximum=4, minimum=4, p25=4, p50=4, p75=4, p90=4, p99=4, p999=4, p9999=4)
Newbird/connection_sent_bytes: (average=120, count=1, maximum=120, minimum=120, p25=120, p50=120, p75=120, p90=120, p99=120, p999=120, p9999=120)
Newbird/request_latency_ms: (average=14, count=4, maximum=39, minimum=2, p25=2, p50=8, p75=10, p90=39, p99=39, p999=39, p9999=39)
```
|
