Spec-Zone .ru спецификации, руководства, описания, API

javax.persistence
Тип аннотации OrderBy

@Target(value={METHOD,FIELD})
@Retention(value=RUNTIME)
public @interface OrderBy

Определяет упорядочивание элементов набора оцененная ассоциация или набор элемента в точке, когда ассоциация или набор получаются.

Синтаксис value упорядочивание элемента orderby_list, следующим образом:

    orderby_list::= orderby_item [,orderby_item]*
    orderby_item::= [property_or_field_name] [ASC | DESC]
 

Если ASC или DESC не определяется, ASC (порядок по возрастанию) принимается.

Если элемент упорядочивания не определяется для ассоциации объекта, упорядочивающий первичным ключом связанного объекта принимается.

Свойство или имя поля должны соответствовать свойству персистентного свойства или полю связанного class или встроили class в пределах этого. Свойства или поля, используемые в упорядочивании, должны соответствовать столбцам, для которых поддерживаются операторы сравнения.

Точка (". "), нотация используется, чтобы обратиться к атрибуту в пределах встроенного атрибута. Значение каждого идентификатора, используемого с записью через точку, является именем соответствующего встроенного поля или свойства.

OrderBy аннотация может быть применена к набору элемента. Когда OrderBy применяется к набору элемента основного типа, упорядочивание будет значением основных объектов и свойства, или имя поля не используется. Определяя упорядочивание по набору элемента встраиваемого типа, запись через точку должна использоваться, чтобы определить атрибут или атрибуты, которые определяют упорядочивание.

OrderBy аннотация не используется, когда столбец порядка определяется.

    Example 1:
    
    @Entity 
    public class Course {
       ...
       @ManyToMany
       @OrderBy("lastname ASC")
       public List<Student> getStudents() {...};
       ...
    }
    
    Example 2:

    @Entity 
    public class Student {
       ...
       @ManyToMany(mappedBy="students")
       @OrderBy // ordering by primary key is assumed
       public List<Course> getCourses() {...};
       ...
    }

    Example 3: 

    @Entity 
    public class Person {
         ...
       @ElementCollection
       @OrderBy("zipcode.zip, zipcode.plusFour")
       public Set<Address> getResidences() {...};
       ...
    }
  
    @Embeddable 
    public class Address {
       protected String street;
       protected String city;
       protected String state;
       @Embedded protected Zipcode zipcode;
    }

    @Embeddable 
    public class Zipcode {
       protected String zip;
       protected String plusFour;
    }
 

С тех пор:

Персистентность Java 1.0

См. Также:

OrderColumn

Дополнительная Сводка Элемента

java.lang.String

значение orderby_list.

значение

public abstract java.lang.String value

orderby_list. Определенный следующим образом:

    orderby_list::= orderby_item [,orderby_item]*
    orderby_item::= [property_or_field_name] [ASC | DESC]
 

Если ASC или DESC не определяется, ASC (порядок по возрастанию) принимается.

Если элемент упорядочивания не определяется, упорядочивая первичным ключом связанного объекта принимается.

Значение по умолчанию:

""