Question

我之前使用Jaxb从事过Web服务。我从xsd生成Java，然后我习惯使用HTTP post将xml请求发布到指定的URL。最近我听说这个Restful网络服务，在阅读时我觉得我之前做过的只是宁静的网络服务。但是，我不确定它是否同样如此。任何人都可以解释一下。

Answer 1

听起来您一直在创建相同类型的RESTful服务。您可能指的是JAX-RS是一种标准，它定义了一种更简单的方法来创建RESTful服务，其中JAXB是application/xml媒体类型的标准绑定层。以下是一个示例服务：

package org.example;

import java.util.List;

import javax.ejb.*;
import javax.persistence.*;
import javax.ws.rs.*;
import javax.ws.rs.core.MediaType;

@Stateless
@LocalBean
@Path("/customers")
public class CustomerService {

    @PersistenceContext(unitName="CustomerService",
                        type=PersistenceContextType.TRANSACTION)
    EntityManager entityManager;

    @POST
    @Consumes(MediaType.APPLICATION_XML)
    public void create(Customer customer) {
        entityManager.persist(customer);
    }

    @GET
    @Produces(MediaType.APPLICATION_XML)
    @Path("{id}")
    public Customer read(@PathParam("id") long id) {
        return entityManager.find(Customer.class, id);
    }

    @PUT
    @Consumes(MediaType.APPLICATION_XML)
    public void update(Customer customer) {
        entityManager.merge(customer);
    }

    @DELETE
    @Path("{id}")
    public void delete(@PathParam("id") long id) {
        Customer customer = read(id);
        if(null != customer) {
            entityManager.remove(customer);
        }
    }

}

了解更多信息

http://blog.bdoughan.com/2010/08/creating-restful-web-service-part-45.html

Answer 2

说到'RESTful'，它只是HTTP方法和url模式的惯例。

CRUD   METHOD   URL                         RESPONSE DESCRIPTION
----------------------------------------------------------------
CREATE POST     http://www.doma.in/people   202      Creates a new person with given entity body
READ   GET      http://www.doma.in/people   200
READ   GET      http://www.doma.in/people/1 200 404  Reads a single person
UPDATE PUT      http://www.doma.in/people/2 204      Updates a single person with given entity body
DELETE DELETE   http://www.doma.in/people/1 204      Deletes a person mapped to given id(1)

您甚至可以使用Sevlets实现这些合同。实际上我在JAX-RS的时代之前就已经完成了Sevlets。

使用JAX-RS时，您的生活会更轻松。

这是Blaise Doughan先生的略微修改版本。 Blaise Doughan先生的代码没有错。

我只是想为上面的网址模式添加更多内容。

JAX-RS可以提供的一件好事是，如果你拥有那些优秀的JAXB类，你可以像客户想要的那样提供XML和JSON。有关这两种格式的相同方法，请参阅@Produces和@Consumes。

当客户希望以Accept: application/xml作为XML接收时，他们只需获取XML。

当客户希望以Accept: application/json作为JSON接收时，他们只获得JSON。

@Path("/customers");
public class CustomersResource {

    /**
     * Reads all person units.
     */
    @POST
    @Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
    public Response read() {
        final List<Customer> listed = customerBean.list();
        final Customers wrapped = Customers.newInstance(listed);
        return Response.ok(wrapped).build();
    }

    @POST
    @Consumes({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
    public Response createCustomer(final Customer customer) {
        entityManager.persist(customer);
        return Response.created("/" + customer.getId()).build();
    }

    @GET
    @Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
    @Path("/{id: \\d+}")
    public Response read(@PathParam("id") final long id) {
        final Customer customer = entityManager.find(Customer.class, id);
        if (customer == null) {
            return Response.status(Status.NOT_FOUND).build();
        }
        return Response.ok(customer).build();
    }

    @PUT
    @Consumes({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
    public void updateCustomer(final Customer customer) {
        entityManager.merge(customer);
    }

    @DELETE
    @Path("/{id: \\d+}")
    public void deleteCustomer(@PathParam("id") final long id) {
        final Customer customer = entityManager.find(Customer.class, id);
        if (customer != null) {
            entityManager.remove(customer);
        }
        return Response.status(Status.NO_CONTENT).build();
    }
}

假设您想要提供一些图像？

@GET
@Path("/{id: \\d+}")
@Produces({"image/png", "image/jpeg"})
public Response readImage(
    @HeaderParam("Accept") String accept,
    @PathParam("id") final long id,
    @QueryParam("width") @DefaultValue("160") final int width,
    @QueryParam("height") @DefaultValue("160") final int height) {

    // get the image
    // resize the image
    // make a BufferedImage for accept(MIME type)
    // rewrite it to an byte[]
    return Response.ok(bytes).build();

    // you can event send as a streaming outout
    return Response.ok(new StreamingOutput(){...}).build();
}

Jaxb在Restful Web服务中

2 个答案: