/* * 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: Embedded.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.ElementType.FIELD; import static java.lang.annotation.ElementType.METHOD; import static java.lang.annotation.RetentionPolicy.RUNTIME; /** * Specifies a persistent field or property of an entity whose * value is an instance of an embeddable class. The embeddable * class must be annotated as {@link Embeddable}. * * <p> The <code>AttributeOverride</code>, <code>AttributeOverrides</code>, * <code>AssociationOverride</code>, and <code>AssociationOverrides</code> * annotations may be used to override mappings declared or defaulted * by the embeddable class. * * <pre> * Example: * * @Embedded * @AttributeOverrides({ * @AttributeOverride(name="startDate", column=@Column("EMP_START")), * @AttributeOverride(name="endDate", column=@Column("EMP_END")) * }) * public EmploymentPeriod getEmploymentPeriod() { ... } * </pre> * * @see Embeddable * @see AttributeOverride * @see AttributeOverrides * @see AssociationOverride * @see AssociationOverrides * * @since Java Persistence 1.0 */ @Target({METHOD, FIELD}) @Retention(RUNTIME) public @interface Embedded { }