/* * Copyright (c) 2008, 2009 Sun Microsystems. All rights reserved. * * This program and the accompanying materials are made available under the * terms of the Eclipse Public License v1.0 and Eclipse Distribution License v. 1.0 * which accompanies this distribution. * The Eclipse Public License is available at http://www.eclipse.org/legal/epl-v10.html * and the Eclipse Distribution License is available at * http://www.eclipse.org/org/documents/edl-v10.php. * * Contributors: * Linda DeMichiel - Java Persistence 2.0 - Version 2.0 (October 1, 2009) * Specification available from http://jcp.org/en/jsr/detail?id=317 */ // $Id: FieldResult.java 20957 2011-06-13 09:58:51Z stliu $ package javax.persistence; import java.lang.annotation.Target; import java.lang.annotation.Retention; import static java.lang.annotation.RetentionPolicy.RUNTIME; /** * Is used to map the columns specified in the SELECT list * of the query to the properties or fields of the entity class. * * <pre> * * Example: * Query q = em.createNativeQuery( * "SELECT o.id AS order_id, " + * "o.quantity AS order_quantity, " + * "o.item AS order_item, " + * "FROM Order o, Item i " + * "WHERE (order_quantity > 25) AND (order_item = i.id)", * "OrderResults"); * * @SqlResultSetMapping(name="OrderResults", * entities={ * @EntityResult(entityClass=com.acme.Order.class, fields={ * @FieldResult(name="id", column="order_id"), * @FieldResult(name="quantity", column="order_quantity"), * @FieldResult(name="item", column="order_item")}) * }) * </pre> * * @since Java Persistence 1.0 */ @Target({}) @Retention(RUNTIME) public @interface FieldResult { /** Name of the persistent field or property of the class. */ String name(); /** * Name of the column in the SELECT clause - i.e., column * aliases, if applicable. */ String column(); }