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

javax.ws.rs.core
Класс GenericEntity <T>

java.lang.Object
  javax.ws.rs.core.GenericEntity<T>

public class GenericEntity<T>
расширяет java.lang. Объект

Представляет объект ответа универсального типа T.

Обычно вводите стирание, удаляет универсальную информацию о типе так, что a Response экземпляр, который содержит, например, объект типа List<String> кажется, содержит сырые данные List<?> во времени выполнения. Когда универсальный тип обязан выбирать подходящее MessageBodyWriter, этот class может использоваться, чтобы обернуть объект и получить его универсальный тип.

Есть два способа создать экземпляр:

1. Создайте (обычно анонимный) подкласс этого class, который включает извлечению информации о типе во времени выполнения несмотря на стирание типа. Например, следующий код показывает, как создать a Response содержа объект типа List<String> чей универсальный тип будет доступен во времени выполнения для выбора подходящего MessageBodyWriter:

   List<String> list = new ArrayList<String>();
   GenericEntity<List<String>> entity = new GenericEntity<List<String>>(list) {};
   Response response = Response.ok(entity).build();

   где list экземпляр List<String> это сформирует тело ответа, и объект является экземпляром анонимного подкласса GenericEntity.

2. Создайте экземпляр непосредственно, предоставляя универсальную информацию типа с объектом. Например следующий код показывает, как создать ответ, содержащий результат метода, вызванного через отражение:

   Method method = ...;
   GenericEntity<Object> entity = new GenericEntity<Object>(
       method.invoke(...), method.getGenericReturnType());
   Response response = Response.ok(entity).build();

Вышеупомянутое получает универсальный тип из типа возврата метода, необработанным типом является class объекта.

Сводка конструктора

protected	GenericEntity(T entity) Создает новый универсальный объект.
	GenericEntity(T entity, java.lang.reflect.Type genericType) Создайте новый экземпляр GenericEntity, предоставляя универсальную информацию типа.

Сводка метода

T	getEntity() Получите включенный объект
java.lang.Class<?>	getRawType() Получает необработанный тип включенного объекта.
java.lang.reflect.Type	getType() Становится базовым Type экземпляр.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

GenericEntity

protected GenericEntity(T entity)

Создает новый универсальный объект. Происходит представлял class от параметра типа. Отметьте, что этот конструктор защищается, пользователи должны создать (обычно анонимный) подкласс как показано выше.

Параметры:

entity - экземпляр объекта, не должен быть нуль

Броски:

IllegalArgumentException - если объект является нулем

GenericEntity

public GenericEntity(T entity,
                     java.lang.reflect.Type genericType)

Создайте новый экземпляр GenericEntity, предоставляя универсальную информацию типа. Объект должен быть присваиваемым переменной предоставленного универсального типа, например, если entity экземпляр ArrayList<String> тогда genericType могло быть то же самое или суперкласс ArrayList с тем же самым универсальным типом как List<String>.

Параметры:

entity - экземпляр объекта, не должен быть нуль

genericType - универсальный тип, не должен быть нуль

Броски:

IllegalArgumentException - если объект не присваиваем переменной предоставленного универсального типа или если объект или genericType являются нулем.

Деталь метода

getRawType

public final java.lang.Class<?> getRawType()

Получает необработанный тип включенного объекта. Отметьте, что это - необработанный тип экземпляра, не необработанный тип параметра типа. То есть в примере во введении, необработанный тип ArrayList нет List.

Возвраты:

необработанный тип

getType

public final java.lang.reflect.Type getType()

Становится базовым Type экземпляр. Отметьте, что это получается из параметра типа, не включенного экземпляра. То есть в примере во введении, тип List<String> нет ArrayList<String>.

Возвраты:

тип

getEntity

public final T getEntity()

Получите включенный объект

Возвраты:

включенный объект