Errata

The page contains:

We have a web page for this book, where we list errata, examples, and any additional
information. You can access this page at:
http://www.oreilly.com/catalog/9780596158040

But that URL contains NO links to the code examples. Could you please post the code examples and build.xml or pom.xml files.

Thank you.

The following code will give a compiler error because of the "accept()" method. The method "request()" is missing. It should precede "accept()".

Customer customer = client.target("http://commerce.com/customers/123")
.accept("application/json")
.get(Customer.class);

List<Customer> customer = client.target("http://commerce.com/customers")
.accept("application/xml")
.get(new GenericType<List<Customer>>() {});

- GET /resteasy/index.html HTTP/1.1
+ GET /resteasy HTTP/1.1

"/resteasy/index.html" returns "HTTP/1.1 404 Not Found". You should use "/resteasy" to get correct "HTTP/1.1 200 OK" response.

Customer id is defined as 771 on page 17 and that same customer's id is 117 on page 18.

The order id is 233, but the self-referencing URI says 133.

<order id="233">
<link rel="self" href="http://example.com/orders/133"/>
<total>$199.02</total>
<date>December 22, 2008 06:56</date>
...
</order>

Minor typo.

...
<order id="233">
<link rel="self" href="http://example.com/orders/133" />
...

I think the number on link should be 233, the same as returned order number.

The update of user "current" properties is non-atomic.

This can lead to user "current" to contain data from two request (if the requests are parallel and a context switch occurs after the first request has copied some but not all of the properties).

I would use customerDB.put(update.getId(), update) instead of copy each property.

The text says that "If your application server is JAX-RS-aware or, in other words, is tightly integrated with JAX-RS, we can declare our ShoppingApplication class as a servlet". I'm using Glasfish V3, which is a JAX-RS-aware application server, but the Application subclass was not recognized as a servlet. Instead, it produces the error below:

java.lang.ClassCastException: com.restfully.shop.services.ShoppingApplication cannot be cast to javax.servlet.Servlet

I believe this is a particularity of each application server and cannot be generalized.

The second example is supposed to apply to application servers that are not JAX-RS aware. In dropping this into a Tomcat6 server with jsr311-api-1.1.jar, the com.jaxrs.vendor.JaxrsVendorServlet is reported as not found. I can't find any mention of this class in the book or any reference to it on the web except in pages that reference this book. Some explanation of what this class is and how to obtain it would be immensely helpful.

The third sentence states: "You also saw how we used the @Path annotation to bind a URI pattern to a Java method."

I believe it should state: "You also saw how we used the @Path annotation to bind a URI pattern to a Java class."

This is the code segment that it refers to.
@Path("/customers")
public interface CustomerResource {

At the top of the Regular Expressions section, the regular expression for only decimals was given as:
@Path("{id : \\d+}")

But I think just \d+ is correct (the double-backslash ends meaning a literal backslash, not what is wanted here.)

In the JAXB code example at the top of the page,
the last line of code should have a cast to Customer class.

Replace
customer = ctx.createUnmarshaller().unmarshall(new StringReader(custString));

With

customer = (Customer) ctx.createUnmarshaller().unmarshall(new StringReader(custString));

The sentence "If it is, it returns null; otherwise, it returns the JAXBContext..." should be written as "If it is, it returns the JAXBContext....; otherweise, it returns null".

The JSON mapping for "name" appears to be incorrect, at least according to rule #1.

Change this:

"name" : "Bill Burke"

To this:

"name" : { "$" : "Bill Burke" }

- Return ctx.createUnmarshaller().unmarshal(outputStream);
+ return ctx.createUnmarshaller().unmarshal(entityStream);

- return Response.ok(entity);
+ return Response.ok(entity).build();


erroneous line returns ResponseBuilder object whereas method declaration expects it to be Response object.

If you think I've contributed in a good way please send me a complimentary copy of the book.
Thanks

Declaration of "variants" local variable should read as follows:

List<Variant> variants = new ArrayList<Variant>();

- UriBuilder builder = UriBuilder.fromClass(CustomerService.class);
+ UriBuilder builder = UriBuilder.fromResource(CustomerService.class);

There are some errors.
The Expires header value is GMT, so it should set TimeZone for Calendar's factory method. And Calendar#set doesn't return Date instance.
So the correct list should be:
Calendar cal = Calendar.getInstance(TimeZone.getTimeZone("GMT"));
cal.set(2010, 5, 15, 16, 0);
builder.expires(cal.getTime());

When a service receives this GET request, it tries to match the current ETag hash of the resource with the one provided within the If-Modified-Since header. This should be the "If-None-Match header".

Since there is no definition of the header variable "If-Not-Modified", it should be "If-Modified-Since" or "If-Unmodified-Since".

The response attribute is md5 of (md5 of credential) and nonce and cnonce and (md5 of uri).
So the first list must
response = md5(H1 + "nonce:nc:cnonce:qop:" + H2);

The list looks as H1 and H2 are literal.

- connetion = (HttpURLConnection) getUrl.openConnection();
+ connetion = (HttpURLConnection)url.openConnection();

change
"throw new RuntimeExceptioin"
to
"throw new RuntimeException"

Also I think that this listing needs more imports e.g. class HttpGet requires:
import org.apache.http.client.methods.HttpGet;
and DefaultHttpClient requires:
import org.apache.http.impl.client.DefaultHttpClient;

Also there is something wrong with this code: InputStreamReader(response.getEntity().getInputStream()));

I think there should be:
InputStreamReader(response.getEntity().getContent()));

Javadoc tells me that there is no getInputStream() method for HttpEntity interface, and correct method is getContent().

It was tested on HttpClient 4.0 and 4.0.1 (from http://archive.apache.org/dist/httpcomponents/httpclient/binary/httpcomponents-client-4.0-bin-with-dependencies.tar.gz) with Oracle JDK6.

Finally my imports looks:
import java.io.*;
import org.apache.http.*;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.DefaultHttpClient;

Regards,
Greg

"In Apache HttpClient 4.x, the org. apache.http.client.DefaultHttpClient class is responsible for managing HTTP connections."
I think there should be org.apache.http.impl.client.DefaultHttpClient (according to Javadoc from http://hc.apache.org/httpcomponents-client-4.0.1/httpclient/apidocs/index.html)

http://shop.oreilly.com/product/9780596158057.do

I tried to download page 176 sample using the above link. However, when I click on Download Example Code.
It brought me to http://www.jboss.org/resteasy.

Please kindly modify the link so that I can learn how to get it from Customer.class.
Thanks

the embedded server is not started. As printed, the code will throw a NullPointerException as server.getDeployment().getRegistry() is null.

In the example source code for ex04_3

The CustomerResource class has the added constructors that would be needed if not doing fully dynamic dispatching.

The CustomerDatabaseResource class in the example also does not have the locateCustomerResource(String db) method, which I believe would have used the added CustomerResource constructor that accepts a Map<Integer, Customer>

The cookie created at #createCustomer is indexed by "/" path, but the cookie referrenced at #getCustomers is indexed by "/rest/customers", so the paragraph on P.226 "If you refresh this page, you will see ..." is wrong.
Need changing the cookie's path.
ie)
- .cookie(new NewCookie("last-visit", lastVisit))
+ .cookie(new NewCookie("last-visit", lastVisit, "/", null, null, NewCookie.DEFAULT_MAX_AGE, false))