Java Restful Web Services （三）——方法注解

Rest与HTTP的区别是什么？HTTP是一种应用协议，而Rest是一套规则，在目前来说，我们仅仅使用了HTTP协议中最常见的GET和POST方法，而REST是一种教我们如何使用HTTP协议的一种方式，REST方式就是教会我们使用HTTP协议中所定义的所有方法。以下演示JAX-RS所定义的这些资源方法指示符注解包括@GET, @PUT, @POST, @DELETE等等。

import java.util.Arrays;

import javax.ws.rs.Consumes;
import javax.ws.rs.DELETE;
import javax.ws.rs.GET;
import javax.ws.rs.POST;
import javax.ws.rs.PUT;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.QueryParam;
import javax.ws.rs.core.MediaType;

import cn.com.icbc.bean.Book;
import cn.com.icbc.bean.Books;
import cn.com.icbc.service.BookService;

@Path("books")
public class BookResource {

//	private static final Logger logger = Logger.getLogger(BookResource.class);

private BookService bookService;

public BookResource() {
bookService = new BookService();
}

@Path("/booktest")
@GET
@Produces(MediaType.TEXT_PLAIN)
public String sayHello() {
return "Hello Books!";
}

@GET
@Produces({ MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML })
public Books getBooks() {

final Books books = bookService.getBooks();
System.out.println("Books in BookResource = "+Arrays.toString(books.getBookList().toArray()));

return books;
}

@Path("{bookid:[0-9]*}")
@GET
@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
public Book getBookByPath(@PathParam("bookid") int bookid) {

System.out.println(bookid);
final Book book = bookService.getBook(bookid);
System.out.println("BookResourcePath = " + book.toString());
return book;
}

@Path("/book")
@GET
@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
public Book getBookByParam(@QueryParam("bookid") int bookid) {

final Book book = bookService.getBook(bookid);
System.out.println("BookResourceQuery = " + book.toString());
return book;
}

@POST
@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
@Consumes({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
public Book saveBook(final Book book) {
System.out.println("enter saveBook");
return bookService.saveBook(book);
}

@Path("{bookid:[0-9]*}")
@PUT
@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
@Consumes({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON,
MediaType.TEXT_XML })
public Book updateBook(@PathParam("bookid") String bookid, final Book book) {
if (book == null) {
return null;
}
return bookService.updateBook(bookid, book);
}

@Path("{bookid:[0-9]*}")
@DELETE
public String deleteBook(@PathParam("bookid") int bookid) {

if (bookService.deleteBook(bookid)) {
return "Deleted book id = " + bookid;
} else {
return "Deleted book failed id = " + bookid;
}
}

}

测试类

import static org.junit.Assert.assertEquals;

import java.util.Arrays;

import javax.ws.rs.client.Client;
import javax.ws.rs.client.ClientBuilder;
import javax.ws.rs.client.Entity;
import javax.ws.rs.client.WebTarget;
import javax.ws.rs.core.MediaType;

import org.junit.After;
import org.junit.AfterClass;
import org.junit.Assert;
import org.junit.Before;
import org.junit.BeforeClass;
import org.junit.Test;

import cn.com.icbc.bean.Book;
import cn.com.icbc.bean.Books;

public class BookResourceTest {

private WebTarget target;
public static final String BASE_URI = "http://localhost:8090/NoteMail/rest/";

@BeforeClass
public static void setUpBeforeClass() throws Exception {
}

@AfterClass
public static void tearDownAfterClass() throws Exception {
}

@Before
public void setUp() throws Exception {
System.out.println("setUp");
Client c = ClientBuilder.newClient();
target = c.target(BASE_URI);
System.out.println(target.getUri());
}

@After
public void tearDown() throws Exception {
}

@Test
public void testGetBooks() {
Books books = target.path("books").request().get(Books.class);
System.out.println("testGetBooks = " + Arrays.toString(books.getBookList().toArray()));
Assert.assertNotNull(books);
}

@Test
public void testGetBookByPath() {
// fail("Not yet implemented");
final int bookId = 3;
System.out.println("testGetBookByPath = "
+ target.path("books/" + bookId).getUri());
final Book book = target.path("books/" + bookId).request()
.get(Book.class);
System.out.println(book == null ? "book is null" : book.toString());
assertEquals(bookId, book.getBookId());
}

@Test
public void testGetBookByParam() {
final int bookId = 3;
final Book book = target.path("books/book")
.queryParam("bookid", bookId).request().get(Book.class);
System.out.println(book == null ? "book is null" : book.toString());
assertEquals(bookId, book.getBookId());
}

@Test
public void testSaveBook() {

final Book newBook = new Book("Java Restful Web Service使用指南"
+ System.nanoTime(), "人民邮电" + System.nanoTime());
final Entity<Book> bookEntity = Entity.entity(newBook,
MediaType.APPLICATION_JSON_TYPE);
System.out.println(bookEntity);
final Book savedBook = target.path("books")
.request(MediaType.APPLICATION_JSON_TYPE)
.post(bookEntity, Book.class);
System.out.println(savedBook.getBookId());
Assert.assertNotNull(savedBook.getBookId());

}

@Test
public void testUpdateBook() {
final Book newBook = new Book(1, "Java Restful Web Service使用指南"
+ System.nanoTime(), "机械工业Update" + System.nanoTime());

final Entity<Book> bookEntity = Entity.entity(newBook,
MediaType.APPLICATION_JSON_TYPE);
System.out.println(bookEntity);
final Book savedBook = target.path("books/1")
.request(MediaType.APPLICATION_JSON_TYPE)
.put(bookEntity, Book.class);
System.out.println(savedBook);
Assert.assertNotNull(savedBook);
}

@Test
public void testDeleteBook() {
String result = target.path("books/2").request().delete(String.class);
System.out.println(result);
Assert.assertNotNull("Deleted book id = 2", result);

}

}

执行结果