Java tutorial
package net.eusashead.hateoas.springhalbuilder.controller; /* * #[license] * Spring HalBuilder Example Webapp * %% * Copyright (C) 2013 Eusa's Head * %% * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * %[license] */ import net.eusashead.hateoas.hal.response.HalResponseBuilder; import net.eusashead.hateoas.response.DeleteResponseBuilder; import net.eusashead.hateoas.response.OptionsResponseBuilder; import net.eusashead.hateoas.response.PutResponseBuilder; import net.eusashead.hateoas.springhalbuilder.model.Customer; import net.eusashead.hateoas.springhalbuilder.repository.CustomerRepository; import net.eusashead.hateoas.springhalbuilder.repository.OrderRepository; import net.eusashead.hateoas.springhalbuilder.representation.CustomerRepresentationWriter; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.http.HttpMethod; import org.springframework.http.ResponseEntity; import org.springframework.stereotype.Controller; import org.springframework.transaction.annotation.Transactional; import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import com.theoryinpractise.halbuilder.api.Representation; @Controller @RequestMapping(CustomerController.URI_TEMPLATE) public class CustomerController { public static final String URI_TEMPLATE = "/customer/{id}"; @Autowired private CustomerRepository customerRepository; @Autowired private OrderRepository orderRepository; @RequestMapping(method = RequestMethod.OPTIONS) public ResponseEntity<Void> options(OptionsResponseBuilder<Void> builder) { return builder.allow(HttpMethod.GET, HttpMethod.HEAD).build(); } /** * Get a {@link Customer} by * identifier in HAL * {@link Representation} format * * @param id identifier of the {@link Customer} to delete * @param builder {@link HalGetResponseBuilder} to build response * @return {@link ResponseEntity} with {@link Representation} of {@link Customer} */ @Transactional @RequestMapping(method = { RequestMethod.GET, RequestMethod.HEAD }) public ResponseEntity<Representation> get(@PathVariable("id") Integer id, HalResponseBuilder builder) { Customer customer = customerRepository.findOne(id); return builder.convert(customer, new CustomerRepresentationWriter()).etag(customer.getVersion()) .lastModified(customer.getUpdated()).build(); } /** * Modify a {@link Customer} * * @param customer {@link Customer} to update * @param builder {@link PutResponseBuilder} to build response * @return {@link ResponseEntity} with null body and HTTP status 204 */ @RequestMapping(method = RequestMethod.PUT) public ResponseEntity<Void> put(@RequestBody Customer customer, PutResponseBuilder<Customer> builder) { Customer saved = customerRepository.save(customer); return builder.etag(saved.getVersion()).lastModified(saved.getUpdated()).build(); } /** * Delete a {@link Customer} * by identifier in the * URI template * * @param id identifier of the {@link Customer} to delete * @param builder {@link DeleteResponseBuilder} to build response * @return {@link ResponseEntity} with null body and HTTP status 204 */ @RequestMapping(method = RequestMethod.DELETE) public ResponseEntity<Void> delete(@PathVariable("id") Integer id, DeleteResponseBuilder builder) { customerRepository.delete(id); return builder.build(); } }