Интерфейс аннотации Serial

@Target({METHOD,FIELD}) @Retention(SOURCE) public @interface Serial

Указывает, что аннотированное поле или метод является частью механизма сериализации, определённого в Спецификации сериализации объектов Java. Этот тип аннотации предназначен для проверки во время компиляции объявлений, связанных с сериализацией, подобно проверке, включаемой типом аннотации Override для проверки переопределения методов. Для классов Serializable рекомендуется использовать аннотации @Serial, чтобы помочь компилятору обнаруживать ошибочные объявления полей и методов, связанных с сериализацией, которые в противном случае может быть трудно выявить.

В частности, аннотации этого типа следует применять к методам и полям, связанным с сериализацией, в классах, объявленных как Serializable. Пять методов, связанных с сериализацией:

• private void writeObject(java.io.ObjectOutputStream stream) throws IOException
• private void readObject(java.io.ObjectInputStream stream) throws IOException, ClassNotFoundException
• private void readObjectNoData() throws ObjectStreamException
• ANY-ACCESS-MODIFIER Object writeReplace() throws ObjectStreamException
• ANY-ACCESS-MODIFIER Object readResolve() throws ObjectStreamException

Два поля, связанные с сериализацией:

• private static final ObjectStreamField[] serialPersistentFields
• private static final long serialVersionUID

Компиляторам рекомендуется проверять, является ли метод или поле, помеченное аннотацией @Serial, одним из определённых методов или полей, связанных с сериализацией и объявленных в подходящем контексте, и выдавать предупреждение в противном случае.

Применение этой аннотации к другим полям или методам является семантической ошибкой, в том числе в следующих случаях:

• поля или методы в классе, который не является Serializable
• поля или методы с правильной структурой объявления, но в типе, в котором они не оказывают эффекта. Например, для типов enum определено значение serialVersionUID, равное 0L, поэтому поле serialVersionUID, объявленное в типе enum, игнорируется. Пять указанных выше методов, связанных с сериализацией, также игнорируются для типа enum.
• в классе, который является Externalizable:
  • объявления методов writeObject, readObject и readObjectNoData
  • объявление поля для serialPersistentFields
  Хотя интерфейс Externalizable расширяет Serializable, три указанных выше метода и одно поле не используются для внешне сериализуемых классов.

Обратите внимание, что механизм сериализации обращается к предназначенным для него полям и методам с помощью рефлексии, поэтому в классе Serializable эти поля и методы могут казаться неиспользуемыми.