The document discusses the JAX-RS 2.0 client API, including that it has 4 core classes, providers must be registered, uses a fluent API with immutable instances, and request bodies are represented by the Entity class.

2. The Newest
JAX-RS Features
Jan Algermissen
NORD Software Consulting
@algermissen • http://jalg.net

3. What’s in 2.0 For Me?

4. What’s in 2.0 For Me?
Client

5. API

6. What’s in 2.0 For Me?
Client

7. API
Filters

8. What’s in 2.0 For Me?
Client

9. API
Filters
Interceptors

10. What’s in 2.0 For Me?
Client

11. API
Filters
Interceptors
Async

12. What’s in 2.0 For Me?
Client

13. API
Filters
Interceptors
Async
Hypermedia

14. What’s in 2.0 For Me?
Client

15. API
Filters
Interceptors
Async
Hypermedia
ResourceContext

16. Client API
Now

17. I

18. am

19. standardized!

20. Client client = ClientFactory.newClient();
client.register(CustomerMessageBodyWriter.class);
client.register(CustomerMessageBodyReader.class);
client.register(SomeFeature.class);
client.setProperty(CLIENT_CACHE_SIZE,100);

21. Aiming at WebTargets
WebTarget crmWt = client
.target(http://example.com/crm);
WebTarget customersWT = crm.path(customers);
WebTarget frenchCustWT = customersWt
.matrixParam(country,france);
WebTarget custSearchWT = frenchCustWT
.queryParam(q,Yves);

22. WebTarget carWT = client
.target(http://example.com/car/{plateNr});
carWT.resolveTemplate(plateNr,HH-TZ-101);
carWT.resolveTemplate(plateNr,M-KL-1982);
carWT.resolveTemplate(plateNr,F-EK-7622);
carWT.resolveTemplate(plateNr,HB-RE-223);
carWT.resolveTemplate(plateNr,B-AM-8719);

23. Launching Requests
Response res =
customerWt
.request(application/customer)
.get();
int status = res.getStatus();
Locale loc = res.getLanguage();
Link editLink = res.getLink(edit);
Customer c = res.readEntity(
Customer.class);

24. Sending Data
WebTarget customersWT = client
.target(http://crm.example.com/customers);
Customer customer = new Customer(Pebbles Flintstone);
Response res = customersWT.request(application/customer).post(
Entity.entity(customer, application/customer));

25. import static javax.ws.rs.client.Entity.*;
...post( Entity.entity(customer, application/customer) );
...post(xml(customer));
...post(json(customer));
...post(text(customer));
...post(html(customer));
...post( form(
new Form(firstname,Pebbles).param(surname , Flintstone)
));
Request entity
encoding optio
ns

26. Why build many...
WebTarget latestCustomersWT = client
.target(http://example.com/customers/latest);
while( keepPolling ) {
Response res = latestCustomersWT.request(application/atom+xml)
.acceptLanguage(de)
.header(...).header(...).get();
...
}

27. ...if you can use just one?
WebTarget latestCustomersWT = client
.target(http://example.com/customers/latest);
Invocation poll = latestCustomersWT
.request(application/atom+xml)
.acceptLanguage(de)
.header(...).header(...).buildGet();
while( keepPolling ) {
Response res = poll.invoke();
...
}

28. Need variations on a theme?
InvocationBuilder pollBuilder = latestCustomersWT
.request(application/atom+xml).acceptLanguage(de)
.header(...).header(...);
while( keepPolling ) {
Response res = pollBuilder.header(If-None-Match,etag).get();
if( notModified )
continue;
...
}

29. Creating a Bunch of Customers
InvocationBuilder createBuilder = customersWT
.request(application/customer)
.acceptLanguage(de)
.header(...).header(...);
for(Customer c : newCustomers ) {
Response res = createBuilder.post(
Entity.entity(c, application/customer));
}
InvocationBuilder

30. works

31.
for

32. sending

33. data,

34. too.

35. @Uri(http://crm/news)
@Uri

36. creates

37. WebTargets.
@Uri(http://example.com/crm)
WebTarget crmServiceWt;
@Uri(entries/latest);
WebTarget latestEntriesWt;

38. @Uri(orders/{name})
Inside

39. a

40.
resource

41. class

42. you

43. may

44. use

45.
templates.
@Path(users/{name})
pulic class UserResource {
@Uri(orders/{name})
WebTarget userOrderWt;
@Uri(http://mail.org/box/{name});
WebTarget userMailboxWt;
}

46. Client API

47. Client API
-

48. 4

49. core

50. classes

51. Client API
-

52. 4

53. core

54. classes
-

55. providers

56. must

57. be

58. .registered()

59. Client API
-

60. 4

61. core

62. classes
-

63. providers

64. must

65. be

66. .registered()
-

67. Fluent

68. API,

69. immutable

70. instances

71. Client API
-

72. 4

73. core

74. classes
-

75. providers

76. must

77. be

78. .registered()
-

79. Fluent

80. API,

81. immutable

82. instances
-

83. .request(

84. [accept]

85. )

86. Client API
-

87. 4

88. core

89. classes
-

90. providers

91. must

92. be

93. .registered()
-

94. Fluent

95. API,

96. immutable

97. instances
-

98. .request(

99. [accept]

100. )
-

101. request

102. body

103. -

104. Entity

105. class

106. Client API
-

107. 4

108. core

109. classes
-

110. providers

111. must

112. be

113. .registered()
-

114. Fluent

115. API,

116. immutable

117. instances
-

118. .request(

119. [accept]

120. )
-

121. request

122. body

123. -

124. Entity

125. class
-

126. separation

127. of

128. concerns

129. (Invocation)

130. Client API
-

131. 4

132. core

133. classes
-

134. providers

135. must

136. be

137. .registered()
-

138. Fluent

139. API,

140. immutable

141. instances
-

142. .request(

143. [accept]

144. )
-

145. request

146. body

147. -

148. Entity

149. class
-

150. separation

151. of

152. concerns

153. (Invocation)
-@Uri

154. @Provider
Filters
public class MyFilter implements
ContainerRequestFilter,
ContainerResponseFilter {
public void filter(ContainerRequestContext req) {
// mutable request
}
public void filter(ContainerRequestContext req,
ContainerResponseContext res) {
// mutable response, immutable request
}
}

155. er
rv e
Se i d
-s

156. er
rv e
Se i d
-s

157. er
rv e
Se i d
-s

158. er
rv e
Se i d
-s

159. er
rv e
Se i d
-s

160. er
rv e
Se i d
-s

161. er
rv e
Se i d
-s

162. er
rv e
Se i d
-s

163. -
nt
lie e
C d si

164. -
nt
lie e
C d si

165. -
nt
lie e
C d si

166. -
nt
lie e
C d si

167. -
nt
lie e
C d si

168. -
nt
lie e
C d si

169. -
nt
lie e
C d si

170. Logging Filter
public void filter(ClientRequestContext req) ... {
log.info( +req.getMethod()+ +req.getUri().toASCIIString());
MultivaluedMapString, String headers = req.getStringHeaders();
for (String key : headers.keySet()) {
ListString values = headers.get(key);
log.info( +key+: +headers.get(key));
}
}

171. Header-Decorating Filter
@Provider
public class CacheControlDecoratorFilter implements
ContainerResponseFilter {
public void filter(ContainerRequestContext req,
ContainerResponseContext res) throws IOException {
res.getHeaders().putSingle(
Cache-Control,max-age=60,must-revalidate);
}
}

172. @Provider @PreMatching
public class RewriteFilter implements
ContainerRequestFilter {
public void filter(ContainerRequestContext req)...{
UriInfo uriInfo = req.getUriInfo();
URI rewrittenUri = uriInfo.getRequestUri();
....
req.setRequestUri(rewrittenUri);
}
}

173. Abort Filter Chain
if( !isValid(authToken) )
req.abortWith(Response.status(401).build());

174. Authentication Filter
@Override
public void filter(ContainerRequestContext req)
throws IOException {
URI loginUri = UriBuilder
.fromMethod(LoginResource.class, getLoginForm)
.build();
String authToken = req.getCookies().get(sid).getValue();
if( !isValid(authToken) ) {
req.abortWith(Response.temporaryRedirect(loginUri).build());
}
}

175. And what about the entity?
public interface ContainerResponseContext {
OutputStream getEntityStream();
Object getEntity();
void setEntityStream(OutputStream outputStream);
void setEntity();
}
Here

176. you

177. see

178. how

179. to

180. access

181.
the

182. response

183. entity.

184. gzip-Filter - 1st Try
public void filter(ContainerResponseContext res) ... {
OutputStream old = res.getEntityStream();
GzipOutputStream gzipFilterStream = new GzipOutputStream(old);
res.setEntityStream(gzipFilterStream);
}

185. gzip-Filter - 1st Try
public void filter(ContainerResponseContext res) ... {
OutputStream old = res.getEntityStream();
GzipOutputStream gzipFilterStream = new GzipOutputStream(old);
res.setEntityStream(gzipFilterStream);
// and at some point...
gzipOutputStream.finish(); ???
}

186. gzip-Filter - 1st Try
public void filter(ContainerResponseContext res) ... {
OutputStream old = res.getEntityStream();
GzipOutputStream gzipFilterStream = new GzipOutputStream(old);
res.setEntityStream(gzipFilterStream);
// and at some point...
gzipOutputStream.finish(); ???
}
Filters

187. done
Need

188. to

189. call

190.
finish

191. after

192. MBW

193. Interceptors

194. @Provider
class MinimalInterceptor implements ReaderInterceptor,
WriterInterceptor {
public Object aroundReadFrom(ReaderInterceptorContext readCtx) {
Object entity = readCtx.proceed();
return entity;
}
public void aroundWriteTo(WriterInterceptorContext writeCtx) {
writeCtx.proceed();
}
}

195. er
rv e
Se i d
-s

196. er
rv e
Se i d
-s

197. -
nt
lie e
C d si

198. -
nt
lie e
C d si

199. Another try
at entity
compr
ession

200. void aroundWriteTo(WriterInterceptorContext ctx) {
OutputStream old = ctx.getOutputStream();
GZIPOutputStream gzipOs = new GZIPOutputStream(old);
ctx.setOutputStream(gzipOs);
try {
ctx.proceed();
} finally {
gzipOutputStream.finish();
ctx.setOutputStream(old);
}
}

201. Houston

202. ...

203. Runtime...
Houston

204. ...

205. Runtime...
-

206. asks

207. MBW

208. for

209. getSize() Houston

210. ...

211. Runtime...
-

212. asks

213. MBW

214. for

215. getSize() Houston

216. ...
-

217. sets

218. Content-Length

219. if

220. not

221. 0

222. Runtime...
-

223. asks

224. MBW

225. for

226. getSize() Houston

227. ...
-

228. sets

229. Content-Length

230. if

231. not

232. 0
-

233. response

234. filters

235. are

236. called

237. Runtime...
-

238. asks

239. MBW

240. for

241. getSize() Houston

242. ...
-

243. sets

244. Content-Length

245. if

246. not

247. 0
-

248. response

249. filters

250. are

251. called
-

252. MBW

253. writeTo()

254. is

255. called

256. Runtime...
-

257. asks

258. MBW

259. for

260. getSize() Houston

261. ...
-

262. sets

263. Content-Length

264. if

265. not

266. 0
-

267. response

268. filters

269. are

270. called
-

271. MBW

272. writeTo()

273. is

274. called
-

275. interceptors

276. wrap

277. around

278. Runtime...
-

279. asks

280. MBW

281. for

282. getSize() Houston

283. ...
-

284. sets

285. Content-Length

286. if

287. not

288. 0
-

289. response

290. filters

291. are

292. called
-

293. MBW

294. writeTo()

295. is

296. called
-

297. interceptors

298. wrap

299. around

300. If

301. they

302. change

303. content

304. the

305. length

306. Runtime...
-

307. asks

308. MBW

309. for

310. getSize() Houston

311. ...
-

312. sets

313. Content-Length

314. if

315. not

316. 0
-

317. response

318. filters

319. are

320. called
-

321. MBW

322. writeTo()

323. is

324. called
-

325. interceptors

326. wrap

327. around

328. If

329. they

330. change

331. content

332. the

333. length
won’t

334. match!

335. getSize()
public interface MessageBodyWriterT {
long getSize(T t, Class? type, Type genericType,
Annotation[] annotations, MediaType mediaType);
}
As of JAX-RS 2.0, the method has been
deprecated and the value returned by the
method is ignored by a JAX-RS runtime. All
MessageBodyWriter implementations are
advised to return -1 from the method.
Responsibility to compute the actual Content-
Length header value has been delegated to

336. Houston,

337. it’s

338.
us

339. again...

340. public Object aroundReadFrom(ReaderInterceptorContext readCtx) {
InputStream in = readCtx.getEntityStream();
readCtx.setInputStream(new GZIPInputStreamStream(in) );
Object entity = readCtx.proceed();
return entity;
}

341. public Object aroundReadFrom(ReaderInterceptorContext readCtx) {
if(! readCtx.getHeaders().getFirst(Content-Encoding) ... ){
// skip
}
InputStream in = readCtx.getEntityStream();
readCtx.setInputStream(new GZIPInputStreamStream(in) );
Object entity = readCtx.proceed();
return entity;
}

342. public void aroundWriteTo(WriterInterceptorContext writeCtx) {
OutputStream out = writeCtx.getOutputStream();
writeCtx.setOutputStream(new GZIPOutputStream(out));
writeCtx.proceed();
}

343. public void aroundWriteTo(WriterInterceptorContext writeCtx) {
// Check whether client said Accept-Encoding: gzip
OutputStream out = writeCtx.getOutputStream();
writeCtx.setOutputStream(new GZIPOutputStream(out));
writeCtx.getHeaders().add(Content-Encoding , gzip);
writeCtx.proceed();
}
Actually,

344. it’s

345. not

346. even

347.
that

348. easy

349. because

350. CE

351. is

352. an

353.
ordered

354. list

355. of

356. tokens

357. Hands off!
Messing with the

358. Buffering the Stream
@Provider
class DigSigInterceptor implements WriterInterceptor {
void aroundWriteTo(WriterInterceptorContext ctx) ... {
ByteArrayOutputStream buffer = new ByteArrayOutputStream();
ctx.setOutputStream(buffer);
ctx.proceed();
String signature = getSignature(buffer);
ctx.getHeaders().putSingle(X-Signature,signature);
outputStream.write(buffer);
}
}

359. Filters and Interceptors

360. Filters and Interceptors
-Seven

361. extension

362. points

363. (4

364. +

365. 1

366. +

367. 2)

368. Filters and Interceptors
-Seven

369. extension

370. points

371. (4

372. +

373. 1

374. +

375. 2)
-@PreMatching

376. filters

377. Filters and Interceptors
-Seven

378. extension

379. points

380. (4

381. +

382. 1

383. +

384. 2)
-@PreMatching

385. filters
-Filters

386. done

387. before

388. entity

389. is

390. streamed

391. Filters and Interceptors
-Seven

392. extension

393. points

394. (4

395. +

396. 1

397. +

398. 2)
-@PreMatching

399. filters
-Filters

400. done

401. before

402. entity

403. is

404. streamed
-Stream

405. not

406. 'flowing

407. through'

408. Filters and Interceptors
-Seven

409. extension

410. points

411. (4

412. +

413. 1

414. +

415. 2)
-@PreMatching

416. filters
-Filters

417. done

418. before

419. entity

420. is

421. streamed
-Stream

422. not

423. 'flowing

424. through'
-Altering

425. stream:

426. handle

427. with

428. care

429. Filters and Interceptors
-Seven

430. extension

431. points

432. (4

433. +

434. 1

435. +

436. 2)
-@PreMatching

437. filters
-Filters

438. done

439. before

440. entity

441. is

442. streamed
-Stream

443. not

444. 'flowing

445. through'
-Altering

446. stream:

447. handle

448. with

449. care
-Architectural

450. mismatch

451. -

452. getSize()

453. Filters and Interceptors
-Seven

454. extension

455. points

456. (4

457. +

458. 1

459. +

460. 2)
-@PreMatching

461. filters
-Filters

462. done

463. before

464. entity

465. is

466. streamed
-Stream

467. not

468. 'flowing

469. through'
-Altering

470. stream:

471. handle

472. with

473. care
-Architectural

474. mismatch

475. -

476. getSize()

477. now

478. ignored

479. Filters vs. Interceptors

480. Filters vs. Interceptors
Interceptors...

481. Filters vs. Interceptors
Interceptors...
-

482. Can

483. write

484. before

485. Filters vs. Interceptors
Interceptors...
-

486. Can

487. write

488. before

490. and

491. after

492. Filters vs. Interceptors
Interceptors...
-

493. Can

494. write

495. before

497. and

498. after
-

499. see

500. stream

501. afterwards

502. Filters vs. Interceptors
Interceptors...
-

503. Can

504. write

505. before

507. and

508. after
-

509. see

510. stream

511. afterwards
-

512. know

513. user

514. entity

515. type

516. Filters vs. Interceptors
Interceptors...
-

517. Can

518. write

519. before

521. and

522. after
-

523. see

524. stream

525. afterwards
-

526. know

527. user

528. entity

529. type
-

530. only

531. invoked

532. when

533. Filters vs. Interceptors
Interceptors...
-

534. Can

535. write

536. before

538. and

539. after
-

540. see

541. stream

542. afterwards
-

543. know

544. user

545. entity

546. type
-

547. only

548. invoked

549. when

551. entity

552. accessed

553. Priorities

554. Priorities
@Provider
@BindingPriority(BindingPriority.AUTHENTICATION)
public class AuthFilter implements ContainerRequestFilter {...}
@Provider
@BindingPriority(BindingPriority.HEADER_DECORATOR)
public class CacheCtrlFilter implements ContainerRequestFilter {..}

555. Binding Priorities
public interface javax.ws.rs.BindingPriority extends
java.lang.annotation.Annotation{
public static final int AUTHENTICATION;
public static final int AUTHORIZATION;
public static final int HEADER_DECORATOR;
public static final int ENTITY_CODER;
public static final int USER;
public abstract int value();
}

556. Reverse

557. Order

558. Reverse

559. Order

560. Chains Are Independent
@Provider @PreMatching This

561. will

562. be

563. called

564. first!
@BindingPriority(BindingPriority.HEADER_DECORATOR)
public class AuthFilter implements ContainerRequestFilter {
...
}
@Provider
@BindingPriority(BindingPriority.AUTHENTICATION)
public class CacheCtrlFilter implements ContainerRequestFilter {
...
}

565. Priorities
-

566. Ordering

567. by

568. binding

569. priorities
-

570. Apply

571. per

572. chain!

573. FILTER INTERCEPTOR
BINDING

574. Default server side
binding of filters
and interceptors is Anyone

575. can

576. see

577. me!
@Provider
public class LoggingFilter implements
ContainerRequestFilter,
ContainerResponseFilter {
...
}

578. What

579. if

580. I

581. don’t

582.
want

583. them

584. applied

585.
globally?

586. @NameBinding
@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(value = RetentionPolicy.RUNTIME)
public @interface Logged { }
What

587. if

588. I

589. don’t

590.
want

591. them

592. applied

593.
globally?

594. @NameBinding
@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(value = RetentionPolicy.RUNTIME)
public @interface Logged { }
What

595. if

596. I

597. don’t

598.
want

599. them

600. applied

601.
globally?
@Provider
@Logged
public class LogFilter ...

602. @NameBinding
@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(value = RetentionPolicy.RUNTIME)
public @interface Logged { }
What

603. if

604. I

605. don’t

606.
want

607. them

608. applied

609.
globally?
@Provider @Path(entries/{id})
@Logged public class EntryResource {
public class LogFilter ...
@GET @Logged
public Entry getEntry() { ... }
}

610. @NameBinding
@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(value = RetentionPolicy.RUNTIME)
public @interface Cacheable {
String cc() default public, must-revalidate;
}
And

611. if

612. I

613. need

614. to

615. pass

616.
information?

617. @NameBinding
@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(value = RetentionPolicy.RUNTIME)
public @interface Cacheable {
String cc() default public, must-revalidate;
}
@GET
@Cacheable(cc=public, maxAge=3600)
public Report getHourlyReport() { ... }
And

618. if

619. I

620. need

621. to

622. pass

623.
information?

624. @Provider
@Cacheable
public class CacheControlDecorator implements
ContainerResponseFilter {
public void filter(ContainerRequestContext requestContext,
ContainerResponseContext responseContext) {
for (Annotation a : responseContext.getEntityAnnotations()) {
if (a.annotationType() == Cacheable.class) {
String cc = ((Cacheable) a).cc();
responseContext.getHeaders().add(Cache-Control, cc);
}
}
}
}
Nice

625. pattern!

626. But what if you
want to bundle

627. @Provider
public class LoggingAndAuditFeature implements DynamicFeature {
void configure(ResourceInfo resourceInfo,Configurable configurable) {
if(MyResource.class.isAssignableFrom(resourceInfo.getResourceClass())
resourceInfo.getResourceMethod().isAnnotationPresent(GET.class)) {
configurable.register(new LoggingFilter());
}
if(OtherResource.class.isAssignableFrom(resourceInfo.getResourceClass())
resourceInfo.getResourceMethod().isAnnotationPresent(GET.class)) {
configurable.register(AuditFilter.class);
}
// more branches, deciding what to register for *this* resource/method
}
}

628. configurable.register(AuditFilter.class);
configurable.register(new LoggingFilter());
Wait

629. a

630. minute!
Did

631. you

632. see

633. that?

634. On the client-side
Nobody

635. can

636. see

637. me

638.
providers only unless

639. you

640. register()

641. me!
take effect if
@Provider
public class LoggingFilter implements
ContainerRequestFilter,
ContainerResponseFilter {
...
}

642. You

643.
can

644. .register(provider)

645.
on

646. each

647. of

648. the

649. 4

650. client

651.
API

652. classes
client.register(LogFilter.class);
customerWt.register(new CustomerMBR());
invocation.register(GzipInterceptor.class);
invocationBuilder.register( ... );

653. Fluent

654. API,

655. returning

656. the

657. same

658.
instance.
customerWt
.register(CustomerMBR.class)
.register(CustomerMBW.class)
.register(AuditFilter.class);

659. But what if you
want to bundle

660. public class ClientCacheFeature implements Feature {
public configure(Configuration configuration) {
configuration.register(ClientCacheInterceptor.class);
configuration.register(ClientCacheHeaderFilter.class);
configuration.setProperty(ClientCacheFeature.CACHE_SIZE,100);
}
}
Client client = clientFactory.newClient();
client.register(ClientCacheFeature.class);
Feature

661. ==

662. combination

663. of

664. providers.

665. Binding .register()

666. Binding .register()
-

667. Named

668. binding,

669. dynamic

670. features

671. Binding .register()
-

672. Named

673. binding,

674. dynamic

675. features
-

676. register(),

677. features

678. Binding .register()
-

679. Named

680. binding,

681. dynamic

682. features
-

683. register(),

684. features
-

685. Dedicated

686. provider

687. instances

688. when

689. Binding .register()
-

690. Named

691. binding,

692. dynamic

693. features
-

694. register(),

695. features
-

696. Dedicated

697. provider

698. instances

699. when

701. configuring

702. Async API I

703. like

704. them

705.
threads

706. in

707. separate

708.
pools!
ADMIN
Long-
HTTP
Runnin
Worker
g
Thread
Thread
s

709. @GET @Path(large-thing)
public void getLargeThing(@Suspended AsyncResponse ar) {
Executors.newSingleThreadExecutor().submit(new Runnable() {
public void run() {
// long running: building the large thing
ar.resume(LARGE THING);
}
They

710. gave

711. you

712.
}); @Suspended

713. and

714.
// Return and handle next
// request immediately
AsyncResponse!
}

715. @GET
@Path(large-thing)
@Asynchronous
public void getLargeThing(@Suspended AsyncResponse ar) {
// long running: building the large thing
ar.resume(THE LARGE THING);
}
@Asynchronous

716.
rocks!

717. @GET
@Path(large-thing)
@Asynchronous
public void getLargeThing(@Suspended AsyncResponse ar) {
// long running: building the large thing
ar.resume(THE LARGE THING);
}
I

718. tell'ya!
@Asynchronous

719.
rocks!

720. @GET @Path(large-thing)
public void getLargeThing(@Suspended AsyncResponse ar) {
ar.setTimeout(15, SECONDS);
ar.setTimeoutHandler(new TimeoutHandler() {
public void handleTimeout(AsyncResponse ar) {
ar.resume(Operation timed out -- please try again);
});
}
Executors.newSingleThreadExecutor().submit(new Runnable() {
public void run() {
// long running: building the large thing
ar.resume(LARGE THING);
}
});
}

721. @GET @Path(large-thing)
public void getLargeThing(@Suspended AsyncResponse ar) {
ar.setTimeout(15, SECONDS);
ar.setTimeoutHandler(new TimeoutHandler() {
public void handleTimeout(AsyncResponse ar) {
log(Still large-thing not finished);
ar.setTimeout(15, SECONDS);
});
}
Executors.newSingleThreadExecutor().submit(new Runnable() {
public void run() {
// long running: building the large thing
ar.resume(LARGE THING);
}
});
}

722. Push
@POST @Path(stock/APPL)
public void subs(@Suspended AsyncResponse ar)
{
if(!subscriberQueue.offer(ar)){
Architectures ar.resume(Response.status(503).
header(Retry-After,10).build());
}
} -subscribe-

723. Push
public void notify(
@Observes StockEvent event) {
AsyncResponse ar = subsQueue.poll();
while(ar != null) {
Architectures ar.resume(event);
ar = subscriberQueue.poll();
}
} -notify-

724. Long-Polling Client
Invocation poll = client
.target(http://example/stocks/APPL)
.register(StockQuoteMBR.class)
.request(application/stockquote)
.buildGet();
while( keepLongPolling ) {
StockQuote quote = poll.invoke(StockQuote.class);
gui.update(quote);
}

725. Async in Client API
calendarWt.request(text/calendar).async().get(
new InvocationCallbackCalendarData() {
You

726. bet!
public void completed(CalendarData cal) {
calendarWidget.display(cal);
}
public void failed(ClientException ex) {
calendarWidget.showMessage(
Event could not be downloaded,
Reason: + ex.getMessage());
}
});
Did

727.
they

728. make

729. me

730.
async,

731. too?

732. Async

733. Async
-Better

734. thread

735. pooling

736. Async
-Better

737. thread

738. pooling
-Response

739. parking

740. Async
-Better

741. thread

742. pooling
-Response

743. parking
-Long

744. polling

745. Async
-Better

746. thread

747. pooling
-Response

748. parking
-Long

749. polling
-

750. Callbacks,

751. Timeouts

752. Async
-Better

753. thread

754. pooling
-Response

755. parking
-Long

756. polling
-

757. Callbacks,

758. Timeouts

759. Async
-Better

760. thread

761. pooling
-Response

762. parking
-Long

763. polling
-

764. Callbacks,

765. Timeouts
-Parallel

766. requests

767. Async
-Better

768. thread

769. pooling
-Response

770. parking
-Long

771. polling
-

772. Callbacks,

773. Timeouts
-Parallel

774. requests
-Callbacks

775. or

776. FutureT

777. Need help
building links?

778. @Path(entries/{id})
public class EntryResource {
@PathParam(id) String id;
@GET
public Entry getEntry() { ... }
@GET @Path(comments)
public Comments getComments() { ... }
}

779. @Path(entries/{id})
public class EntryResource {
@PathParam(id) String id;
@GET
public Entry getEntry() { ... }
@GET @Path(comments)
public Comments getComments() { ... }
}
ub1 = UriBuilder.fromResource(EntryResource.class);
ub2 = UriBuilder.fromMethod(EntryResource.class,getComments);

780. @Path(entries/{id})
public class EntryResource {
@PathParam(id) String id;
@GET
public Entry getEntry() { ... }
@GET @Path(comments)
public Comments getComments() { ... }
}
ub1 = UriBuilder.fromResource(EntryResource.class);
ub2 = UriBuilder.fromMethod(EntryResource.class,getComments);
uri = ub2.build(42); // entries/42/comments

781. lb1 = LinkBuilder
.fromResource(EntryResource.class,edit);
lb2 = LinkBuilder
.fromMethod(EntryResource.class,getComments,comments);

782. lb1 = LinkBuilder
.fromResource(EntryResource.class,edit);
lb2 = LinkBuilder
.fromMethod(EntryResource.class,getComments,comments);
link = lb1.build(42);

783. lb1 = LinkBuilder
.fromResource(EntryResource.class,edit);
lb2 = LinkBuilder
.fromMethod(EntryResource.class,getComments,comments);
link = lb1.build(42);
String headerValue = link.toString();

784. lb1 = LinkBuilder
.fromResource(EntryResource.class,edit);
lb2 = LinkBuilder
.fromMethod(EntryResource.class,getComments,comments);
link = lb1.build(42);
String headerValue = link.toString();
// yields: entries/42; rel=edit

785. Not Just in Resources
@Provider
public class MyFilter implements ContainerResponseFilter {
private Link serviceLink =
Link.fromResource(Service.class,service).build();
public void filter(ContainerRequestContext req,
ContainerResponseContext res) throws IOException {
res.getHeaders().add(Link,serviceLink.toString());
}
}

786. Linking

787. Linking
-

788. From

789. resource

790. or

791. method

792. Linking
-

793. From

794. resource

795. or

796. method
-

797. Are

798. relative

799. links

800. indeed

801. useful?

802. Linking
-

803. From

804. resource

805. or

806. method
-

807. Are

808. relative

809. links

810. indeed

811. useful?

812. Wouldn’t

813. DI

814.
in

815. subresource

816. locators

817.
make

818. this

819. darn

820. mission

821.
easier?
One more thing...
Nicht gut - nimm ein
image

822. @Path(entries)
public class EntriesResource { Subresource
@Path({id})
public EntryResource findEntry(@PathParam(id) String id) {
return new EntryResource(id);
}
}

823. @Path(entries)
public class EntriesResource { Subresource
@Path({id})
public EntryResource findEntry(@PathParam(id) String id) {
return new EntryResource(id);
}
}
public class EntryResource {
public EntryResource(String id) { ... }
@GET
public Entry getEntry() {
...
}
}

824. @Path(entries)
public class EntriesResource { Subresource
@Path({id})
public EntryResource findEntry(@PathParam(id) String id) {
return new EntryResource(id);
}
}
public class EntryResource {
No D
public EntryResource(String id) { ... }
@GET
I her
public Entry getEntry() {
}
...
e!
}

825. @Path(entries)
public class EntriesResource {
@Context ResourceContext rc; Subresource
@Path({id})
public EntryResource findEntry(@PathParam(id) String id) {
return rc.initResource(new EntryResource(id));
}
}

826. @Path(entries)
public class EntriesResource {
@Context ResourceContext rc; Subresource
@Path({id})
public EntryResource findEntry(@PathParam(id) String id) {
return rc.initResource(new EntryResource(id));
}
}
public class EntryResource {
@Context HttpHeaders headers;
public EntryResource(String id) { ... }
@GET
public Entry getEntry() {
return new Entry();
}
}

827. @Provider
class TestFilter implements ContainerRequestFilter {
@Context
ResourceContext rc;
void filter(ContainerRequestContext requestContext) ... {
Widget w = rc.getResource(Widget.class);
Gadget g = rc.initResource(new Gadget(...));
}
}
And

828. what

829. about

830.
DI

831. in

832. filters?

833. public class Widget {
@PathParam(id) String id;
public Widget(@HeaderParam(Referer) String referer) { ... }
}
public class Gadget {
@PathParam(id) String id;
@HeaderParam(Referer) String referer
public Gadget(int foo) { ... }
}
Nice!

834. DI

835. anywhere.

836. @Provider
class MyInterceptor implements WriterInterceptor {
@Context ResourceContext rc;
public void aroundWriteTo(WriterInterceptorContext ctx) ... {
OutputStream os = ctx.getOutputStream();
MyFilterOutputStream fos = rc.initResource(
new MyFilterOutputStream(os) );
ctx.setOutputStream(fos);
ctx.proceed();
}
}

837. public class MyFilterOutputStream extends FilterOutputStream {
@PathParam(id) String id;
@HeaderParam(Referer) String referer
public MyFilterOutputStream( OutputStream os) {
super(os);
}
public write(byte[] b) {
// use request information while filtering stream
}
}

838. @Provider @PreMatching
class TestFilter implements ContainerRequestFilter { W
@ on
’t
@Context
Pr wo
ResourceContext rc;
e M rk
void filter(ContainerRequestContext requestContext) ... { at wi
ch th
Widget w = rc.getResource(Widget.class); in
Gadget g = rc.initResource(new Gadget(...));
g
}
}

839. ResourceContext

840. ResourceContext
-

841. DI

842. for

843. subresource

844. locators

845. ResourceContext
-

846. DI

847. for

848. subresource

849. locators
-

850. Even

851. better:

852. DI

853. for

854. any

855. instance

856. ResourceContext
-

857. DI

858. for

859. subresource

860. locators
-

861. Even

862. better:

863. DI

864. for

865. any

866. instance
-

867. e.g.

868. stream

869. filters

870. 2.0 - Wrapping Up

871. 2.0 - Wrapping Up
-

872. Consolidation

873. (Client

874. API,

875. Filters,

876. Interceptors)

877. 2.0 - Wrapping Up
-

878. Consolidation

879. (Client

880. API,

881. Filters,

882. Interceptors)
-

883. Invocation,

884. InvocationBuilder

885. 2.0 - Wrapping Up
-

886. Consolidation

887. (Client

888. API,

889. Filters,

890. Interceptors)
-

891. Invocation,

892. InvocationBuilder
-

893. Filters/Interceptors

894. 2.0 - Wrapping Up
-

895. Consolidation

896. (Client

897. API,

898. Filters,

899. Interceptors)
-

900. Invocation,

901. InvocationBuilder
-

902. Filters/Interceptors
-

903. Advice:

904. careful

905. with

906. altering

907. stream

908. 2.0 - Wrapping Up
-

909. Consolidation

910. (Client

911. API,

912. Filters,

913. Interceptors)
-

914. Invocation,

915. InvocationBuilder
-

916. Filters/Interceptors
-

917. Advice:

918. careful

919. with

920. altering

921. stream
-

922. Async

923. support

924. (pooling,

925. Comet

926. arch.,

927. async

928. client)

929. 2.0 - Wrapping Up
-

930. Consolidation

931. (Client

932. API,

933. Filters,

934. Interceptors)
-

935. Invocation,

936. InvocationBuilder
-

937. Filters/Interceptors
-

938. Advice:

939. careful

940. with

941. altering

942. stream
-

943. Async

944. support

945. (pooling,

946. Comet

947. arch.,

948. async

949. client)
-

950. Hypermedia

951. support

952. 2.0 - Wrapping Up
-

953. Consolidation

954. (Client

955. API,

956. Filters,

957. Interceptors)
-

958. Invocation,

959. InvocationBuilder
-

960. Filters/Interceptors
-

961. Advice:

962. careful

963. with

964. altering

965. stream
-

966. Async

967. support

968. (pooling,

969. Comet

970. arch.,

971. async

972. client)
-

973. Hypermedia

974. support
-

975. Injectable

976. ResourceContext

977. (DI

978. anywhere)

979. Framework

980. support

981.
is

982. underway!
Jersey Final

983. in

984. first

985. half

986. of

987. 2013
RESTEasy Final

988. in

989. first

990. half

991. of

992. 2013
Apache