FullTextQueryImpl (Red Hat JBoss Enterprise Application Platform 6.4.19.GA public API)

java.lang.Object
- org.hibernate.search.jpa.impl.FullTextQueryImpl

All Implemented Interfaces:

Query, FullTextQuery, org.hibernate.search.ProjectionConstants
```
public class FullTextQueryImpl
extends Object
implements FullTextQuery
```
Implements JPA 2 query interface and delegate the call to a Hibernate Core FullTextQuery. This has the consequence of "duplicating" the JPA 2 query logic in some areas.

Author:

Emmanuel Bernard

Field Summary
- Fields inherited from interface org.hibernate.search.ProjectionConstants
  DOCUMENT, DOCUMENT_ID, EXPLANATION, ID, OBJECT_CLASS, SCORE, SPATIAL_DISTANCE, THIS

Constructor Summary

Constructors
Constructor and Description

FullTextQueryImpl(FullTextQuery query, Session session)

Constructors
Constructor and Description
`FullTextQueryImpl(FullTextQuery query, Session session)`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`disableFullTextFilter(String name)` Disable a given filter by its name
`org.hibernate.search.FullTextFilter`	`enableFullTextFilter(String name)` Enable a given filter by its name.
`int`	`executeUpdate()` Execute an update or delete statement.
`org.apache.lucene.search.Explanation`	`explain(int documentId)` Return the Lucene `Explanation` object describing the score computation for the matching object/document in the current query
`org.hibernate.search.query.engine.spi.FacetManager`	`getFacetManager()`
`int`	`getFirstResult()` The position of the first result the query object was set to retrieve.
`FlushModeType`	`getFlushMode()` Get the flush mode in effect for the query execution.
`Map<String,Object>`	`getHints()` Get the properties and hints and associated values that are in effect for the query instance.
`LockModeType`	`getLockMode()` Get the current lock mode for the query.
`int`	`getMaxResults()` The maximum number of results the query object was set to retrieve.
`Parameter<?>`	`getParameter(int position)` Get the parameter object corresponding to the declared positional parameter with the given position.
`<T> Parameter<T>`	`getParameter(int position, Class<T> type)` Get the parameter object corresponding to the declared positional parameter with the given position and type.
`Parameter<?>`	`getParameter(String name)` Get the parameter object corresponding to the declared parameter of the given name.
`<T> Parameter<T>`	`getParameter(String name, Class<T> type)` Get the parameter object corresponding to the declared parameter of the given name and type.
`Set<Parameter<?>>`	`getParameters()` Get the parameter objects corresponding to the declared parameters of the query.
`Object`	`getParameterValue(int position)` Return the value bound to the positional parameter.
`<T> T`	`getParameterValue(Parameter<T> param)` Return the value bound to the parameter.
`Object`	`getParameterValue(String name)` Return the value bound to the named parameter.
`List`	`getResultList()` Execute a SELECT query and return the query results as an untyped List.
`int`	`getResultSize()` Returns the number of hits for this search Caution: The number of results might be slightly different from `getResultList().size()` because getResultList() may be not in sync with the database at the time of query.
`Object`	`getSingleResult()` Execute a SELECT query that returns a single untyped result.
`boolean`	`hasPartialResults()` Experimental API, subject to change or removal When using `FullTextQuery.limitExecutionTimeTo(long, java.util.concurrent.TimeUnit)` }, returns true if partial results are returned (ie if the time limit has been reached and the result fetching process has been terminated.
`FullTextQuery`	`initializeObjectsWith(org.hibernate.search.query.ObjectLookupMethod lookupMethod, org.hibernate.search.query.DatabaseRetrievalMethod retrievalMethod)` Refine the strategies used to load entities.
`boolean`	`isBound(Parameter<?> param)` Return a boolean indicating whether a value has been bound to the parameter.
`FullTextQuery`	`limitExecutionTimeTo(long timeout, TimeUnit timeUnit)` Experimental API, subject to change or removal Limit the time used by Hibernate Search to execute the query.
`FullTextQuery`	`setCriteriaQuery(Criteria criteria)` Defines the Database Query used to load the Lucene results.
`FullTextQuery`	`setFilter(org.apache.lucene.search.Filter filter)` Allows to use lucene filters.
`Query`	`setFirstResult(int firstResult)` Set the position of the first result to retrieve.
`Query`	`setFlushMode(FlushModeType flushMode)` Set the flush mode type to be used for the query execution.
`Query`	`setHint(String hintName, Object value)` Set a query property or hint.
`Query`	`setLockMode(LockModeType lockModeType)` Set the lock mode type to be used for the query execution.
`Query`	`setMaxResults(int maxResults)` Set the maximum number of results to retrieve.
`Query`	`setParameter(int position, Calendar value, TemporalType temporalType)` Bind an instance of `java.util.Calendar` to a positional parameter.
`Query`	`setParameter(int position, Date value, TemporalType temporalType)` Bind an instance of `java.util.Date` to a positional parameter.
`Query`	`setParameter(int position, Object value)` Bind an argument to a positional parameter.
`Query`	`setParameter(Parameter<Calendar> calendarParameter, Calendar calendar, TemporalType temporalType)` Bind an instance of `java.util.Calendar` to a `Parameter` object.
`Query`	`setParameter(Parameter<Date> dateParameter, Date date, TemporalType temporalType)` Bind an instance of `java.util.Date` to a `Parameter` object.
`<T> Query`	`setParameter(Parameter<T> tParameter, T t)` Bind the value of a `Parameter` object.
`Query`	`setParameter(String name, Calendar value, TemporalType temporalType)` Bind an instance of `java.util.Calendar` to a named parameter.
`Query`	`setParameter(String name, Date value, TemporalType temporalType)` Bind an instance of `java.util.Date` to a named parameter.
`Query`	`setParameter(String name, Object value)` Bind an argument to a named parameter.
`FullTextQuery`	`setProjection(String... fields)` Defines the Lucene field names projected and returned in a query result Each field is converted back to it's object representation, an Object[] being returned for each "row" (similar to an HQL or a Criteria API projection).
`FullTextQuery`	`setResultTransformer(ResultTransformer transformer)` defines a result transformer used during projection
`FullTextQuery`	`setSort(org.apache.lucene.search.Sort sort)` Allows to let lucene sort the results.
`FullTextQuery`	`setSpatialParameters(org.hibernate.search.spatial.Coordinates center, String fieldName)` Defines the center of the spatial search for this query to project distance in results
`FullTextQuery`	`setSpatialParameters(double latitude, double longitude, String fieldName)` Defines the center of the spatial search for this query to project distance in results
`<T> T`	`unwrap(Class<T> type)` Return an object of the specified type to allow access to the provider-specific API.
`PersistenceException`	`wrapLockException(HibernateException e, LockOptions lockOptions)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - FullTextQueryImpl
```
public FullTextQueryImpl(FullTextQuery query,
                 Session session)
```
- Method Detail
  - setSort
```
public FullTextQuery setSort(org.apache.lucene.search.Sort sort)
```
    Description copied from interface: FullTextQuery
    
    Allows to let lucene sort the results. This is useful when you have additional sort requirements on top of the default lucene ranking. Without lucene sorting you would have to retrieve the full result set and order the hibernate objects.
    
    Specified by:
    
    setSort in interface FullTextQuery
    
    Parameters:
    sort - The lucene sort object.
    
    Returns:
    this for method chaining
  - setFilter
```
public FullTextQuery setFilter(org.apache.lucene.search.Filter filter)
```
    Description copied from interface: FullTextQuery
    
    Allows to use lucene filters. Semi-deprecated? a preferred way is to use the @FullTextFilterDef approach
    
    Specified by:
    
    setFilter in interface FullTextQuery
    
    Parameters:
    filter - The lucene filter.
    
    Returns:
    this for method chaining
  - getResultSize
```
public int getResultSize()
```
    Description copied from interface: FullTextQuery
    
    Returns the number of hits for this search Caution: The number of results might be slightly different from getResultList().size() because getResultList() may be not in sync with the database at the time of query.
    
    Specified by:
    
    getResultSize in interface FullTextQuery
  - setCriteriaQuery
```
public FullTextQuery setCriteriaQuery(Criteria criteria)
```
    Description copied from interface: FullTextQuery
    
    Defines the Database Query used to load the Lucene results. Useful to load a given object graph by refining the fetch modes No projection (criteria.setProjection() ) allowed, the root entity must be the only returned type No where restriction can be defined either.
    
    Specified by:
    
    setCriteriaQuery in interface FullTextQuery
  - setProjection
```
public FullTextQuery setProjection(String... fields)
```
    Description copied from interface: FullTextQuery
    
    Defines the Lucene field names projected and returned in a query result Each field is converted back to it's object representation, an Object[] being returned for each "row" (similar to an HQL or a Criteria API projection). A projectable field must be stored in the Lucene index and use a TwoWayFieldBridge Unless notified in their JavaDoc, all built-in bridges are two-way. All @DocumentId fields are projectable by design. If the projected field is not a projectable field, null is returned in the object[]
    
    Specified by:
    
    setProjection in interface FullTextQuery
  - setSpatialParameters
```
public FullTextQuery setSpatialParameters(double latitude,
                                 double longitude,
                                 String fieldName)
```
    Description copied from interface: FullTextQuery
    
    Defines the center of the spatial search for this query to project distance in results
    
    Specified by:
    
    setSpatialParameters in interface FullTextQuery
    
    Parameters:
    latitude - latitude of the search center
    longitude - longitude of the search center
    fieldName - name of the spatial field
    
    Returns:
    this for method chaining
  - setSpatialParameters
```
public FullTextQuery setSpatialParameters(org.hibernate.search.spatial.Coordinates center,
                                 String fieldName)
```
    Description copied from interface: FullTextQuery
    
    Defines the center of the spatial search for this query to project distance in results
    
    Specified by:
    
    setSpatialParameters in interface FullTextQuery
    
    Parameters:
    center - the search center
    fieldName - name of the spatial field
    
    Returns:
    this for method chaining
  - enableFullTextFilter
```
public org.hibernate.search.FullTextFilter enableFullTextFilter(String name)
```
    Description copied from interface: FullTextQuery
    
    Enable a given filter by its name. Returns a FullTextFilter object that allows filter parameter injection
    
    Specified by:
    
    enableFullTextFilter in interface FullTextQuery
  - disableFullTextFilter
```
public void disableFullTextFilter(String name)
```
    Description copied from interface: FullTextQuery
    
    Disable a given filter by its name
    
    Specified by:
    
    disableFullTextFilter in interface FullTextQuery
  - setResultTransformer
```
public FullTextQuery setResultTransformer(ResultTransformer transformer)
```
    Description copied from interface: FullTextQuery
    
    defines a result transformer used during projection
    
    Specified by:
    
    setResultTransformer in interface FullTextQuery
  - getResultList
```
public List getResultList()
```
    Description copied from interface: Query
    
    Execute a SELECT query and return the query results as an untyped List.
    
    Specified by:
    
    getResultList in interface Query
    
    Returns:
    a list of the results
  - getFacetManager
```
public org.hibernate.search.query.engine.spi.FacetManager getFacetManager()
```
    Specified by:
    
    getFacetManager in interface FullTextQuery
    
    Returns:
    return the manager for all faceting related operations
  - wrapLockException
```
public PersistenceException wrapLockException(HibernateException e,
                                     LockOptions lockOptions)
```
  - getSingleResult
```
public Object getSingleResult()
```
    Description copied from interface: Query
    
    Execute a SELECT query that returns a single untyped result.
    
    Specified by:
    
    getSingleResult in interface Query
    
    Returns:
    the result
  - setMaxResults
```
public Query setMaxResults(int maxResults)
```
    Description copied from interface: Query
    
    Set the maximum number of results to retrieve.
    
    Specified by:
    
    setMaxResults in interface Query
    
    Parameters:
    maxResults - maximum number of results to retrieve
    
    Returns:
    the same query instance
  - getMaxResults
```
public int getMaxResults()
```
    Description copied from interface: Query
    
    The maximum number of results the query object was set to retrieve. Returns Integer.MAX_VALUE if setMaxResults was not applied to the query object.
    
    Specified by:
    
    getMaxResults in interface Query
    
    Returns:
    maximum number of results
  - setFirstResult
```
public Query setFirstResult(int firstResult)
```
    Description copied from interface: Query
    
    Set the position of the first result to retrieve.
    
    Specified by:
    
    setFirstResult in interface Query
    
    Parameters:
    firstResult - position of the first result, numbered from 0
    
    Returns:
    the same query instance
  - getFirstResult
```
public int getFirstResult()
```
    Description copied from interface: Query
    
    The position of the first result the query object was set to retrieve. Returns 0 if setFirstResult was not applied to the query object.
    
    Specified by:
    
    getFirstResult in interface Query
    
    Returns:
    position of the first result
  - explain
```
public org.apache.lucene.search.Explanation explain(int documentId)
```
    Description copied from interface: FullTextQuery
    
    Return the Lucene Explanation object describing the score computation for the matching object/document in the current query
    
    Specified by:
    
    explain in interface FullTextQuery
    
    Parameters:
    documentId - Lucene Document id to be explain. This is NOT the object id
    
    Returns:
    Lucene Explanation
  - limitExecutionTimeTo
```
public FullTextQuery limitExecutionTimeTo(long timeout,
                                 TimeUnit timeUnit)
```
    Description copied from interface: FullTextQuery
    
    *Experimental* API, subject to change or removal Limit the time used by Hibernate Search to execute the query. When the limit is reached, results already fetched are returned. This time limit is a best effort. The query will likely run for longer than the provided time. The time limit only applies to the interactions between Hibernate Search and Lucene. In other words, a query to the database will not be limited. If the limit is reached and all results are not yet fetched, FullTextQuery.hasPartialResults() returns true.
    
    Specified by:
    
    limitExecutionTimeTo in interface FullTextQuery
    
    Parameters:
    timeout - time out period
    timeUnit - time out unit
  - hasPartialResults
```
public boolean hasPartialResults()
```
    Description copied from interface: FullTextQuery
    
    *Experimental* API, subject to change or removal When using FullTextQuery.limitExecutionTimeTo(long, java.util.concurrent.TimeUnit) }, returns true if partial results are returned (ie if the time limit has been reached and the result fetching process has been terminated.
    
    Specified by:
    
    hasPartialResults in interface FullTextQuery
  - initializeObjectsWith
```
public FullTextQuery initializeObjectsWith(org.hibernate.search.query.ObjectLookupMethod lookupMethod,
                                  org.hibernate.search.query.DatabaseRetrievalMethod retrievalMethod)
```
    Description copied from interface: FullTextQuery
    
    Refine the strategies used to load entities. The lookup method defines whether or not to lookup first in the second level cache or the persistence context before trying to initialize objects from the database. Defaults to SKIP. The database retrieval method defines how objects are loaded from the database. Defaults to QUERY. Note that Hibernate Search can deviate from these choices when it makes sense.
    
    Specified by:
    
    initializeObjectsWith in interface FullTextQuery
  - executeUpdate
```
public int executeUpdate()
```
    Description copied from interface: Query
    
    Execute an update or delete statement.
    
    Specified by:
    
    executeUpdate in interface Query
    
    Returns:
    the number of entities updated or deleted
  - setHint
```
public Query setHint(String hintName,
            Object value)
```
    Description copied from interface: Query
    
    Set a query property or hint. The hints elements may be used to specify query properties and hints. Properties defined by this specification must be observed by the provider. Vendor-specific hints that are not recognized by a provider must be silently ignored. Portable applications should not rely on the standard timeout hint. Depending on the database in use and the locking mechanisms used by the provider, this hint may or may not be observed.
    
    Specified by:
    
    setHint in interface Query
    
    Parameters:
    hintName - name of the property or hint
    value - value for the property or hint
    
    Returns:
    the same query instance
  - getHints
```
public Map<String,Object> getHints()
```
    Description copied from interface: Query
    
    Get the properties and hints and associated values that are in effect for the query instance.
    
    Specified by:
    
    getHints in interface Query
    
    Returns:
    query properties and hints
  - setParameter
```
public <T> Query setParameter(Parameter<T> tParameter,
                     T t)
```
    Description copied from interface: Query
    
    Bind the value of a Parameter object.
    
    Specified by:
    
    setParameter in interface Query
    
    Parameters:
    tParameter - parameter object
    t - parameter value
    
    Returns:
    the same query instance
  - setParameter
```
public Query setParameter(Parameter<Calendar> calendarParameter,
                 Calendar calendar,
                 TemporalType temporalType)
```
    Description copied from interface: Query
    
    Bind an instance of java.util.Calendar to a Parameter object.
    
    Specified by:
    
    setParameter in interface Query
    
    Parameters:
    calendarParameter - parameter object
    calendar - parameter value
    temporalType - temporal type
    
    Returns:
    the same query instance
  - setParameter
```
public Query setParameter(Parameter<Date> dateParameter,
                 Date date,
                 TemporalType temporalType)
```
    Description copied from interface: Query
    
    Bind an instance of java.util.Date to a Parameter object.
    
    Specified by:
    
    setParameter in interface Query
    
    Parameters:
    dateParameter - parameter object
    date - parameter value
    temporalType - temporal type
    
    Returns:
    the same query instance
  - setParameter
```
public Query setParameter(String name,
                 Object value)
```
    Description copied from interface: Query
    
    Bind an argument to a named parameter.
    
    Specified by:
    
    setParameter in interface Query
    
    Parameters:
    name - parameter name
    value - parameter value
    
    Returns:
    the same query instance
  - setParameter
```
public Query setParameter(String name,
                 Date value,
                 TemporalType temporalType)
```
    Description copied from interface: Query
    
    Bind an instance of java.util.Date to a named parameter.
    
    Specified by:
    
    setParameter in interface Query
    
    Parameters:
    name - parameter name
    value - parameter value
    temporalType - temporal type
    
    Returns:
    the same query instance
  - setParameter
```
public Query setParameter(String name,
                 Calendar value,
                 TemporalType temporalType)
```
    Description copied from interface: Query
    
    Bind an instance of java.util.Calendar to a named parameter.
    
    Specified by:
    
    setParameter in interface Query
    
    Parameters:
    name - parameter name
    value - parameter value
    temporalType - temporal type
    
    Returns:
    the same query instance
  - setParameter
```
public Query setParameter(int position,
                 Object value)
```
    Description copied from interface: Query
    
    Bind an argument to a positional parameter.
    
    Specified by:
    
    setParameter in interface Query
    
    Parameters:
    position - position
    value - parameter value
    
    Returns:
    the same query instance
  - setParameter
```
public Query setParameter(int position,
                 Date value,
                 TemporalType temporalType)
```
    Description copied from interface: Query
    
    Bind an instance of java.util.Date to a positional parameter.
    
    Specified by:
    
    setParameter in interface Query
    
    Parameters:
    position - position
    value - parameter value
    temporalType - temporal type
    
    Returns:
    the same query instance
  - getParameters
```
public Set<Parameter<?>> getParameters()
```
    Description copied from interface: Query
    
    Get the parameter objects corresponding to the declared parameters of the query. Returns empty set if the query has no parameters. This method is not required to be supported for native queries.
    
    Specified by:
    
    getParameters in interface Query
    
    Returns:
    set of the parameter objects
  - setParameter
```
public Query setParameter(int position,
                 Calendar value,
                 TemporalType temporalType)
```
    Description copied from interface: Query
    
    Bind an instance of java.util.Calendar to a positional parameter.
    
    Specified by:
    
    setParameter in interface Query
    
    Parameters:
    position - position
    value - parameter value
    temporalType - temporal type
    
    Returns:
    the same query instance
  - getParameter
```
public Parameter<?> getParameter(String name)
```
    Description copied from interface: Query
    
    Get the parameter object corresponding to the declared parameter of the given name. This method is not required to be supported for native queries.
    
    Specified by:
    
    getParameter in interface Query
    
    Parameters:
    name - parameter name
    
    Returns:
    parameter object
  - getParameter
```
public Parameter<?> getParameter(int position)
```
    Description copied from interface: Query
    
    Get the parameter object corresponding to the declared positional parameter with the given position. This method is not required to be supported for native queries.
    
    Specified by:
    
    getParameter in interface Query
    
    Parameters:
    position - position
    
    Returns:
    parameter object
  - getParameter
```
public <T> Parameter<T> getParameter(String name,
                            Class<T> type)
```
    Description copied from interface: Query
    
    Get the parameter object corresponding to the declared parameter of the given name and type. This method is required to be supported for criteria queries only.
    
    Specified by:
    
    getParameter in interface Query
    
    Parameters:
    name - parameter name
    type - type
    
    Returns:
    parameter object
  - getParameter
```
public <T> Parameter<T> getParameter(int position,
                            Class<T> type)
```
    Description copied from interface: Query
    
    Get the parameter object corresponding to the declared positional parameter with the given position and type. This method is not required to be supported by the provider.
    
    Specified by:
    
    getParameter in interface Query
    
    Parameters:
    position - position
    type - type
    
    Returns:
    parameter object
  - isBound
```
public boolean isBound(Parameter<?> param)
```
    Description copied from interface: Query
    
    Return a boolean indicating whether a value has been bound to the parameter.
    
    Specified by:
    
    isBound in interface Query
    
    Parameters:
    param - parameter object
    
    Returns:
    boolean indicating whether parameter has been bound
  - getParameterValue
```
public <T> T getParameterValue(Parameter<T> param)
```
    Description copied from interface: Query
    
    Return the value bound to the parameter.
    
    Specified by:
    
    getParameterValue in interface Query
    
    Parameters:
    param - parameter object
    
    Returns:
    parameter value
  - getParameterValue
```
public Object getParameterValue(String name)
```
    Description copied from interface: Query
    
    Return the value bound to the named parameter.
    
    Specified by:
    
    getParameterValue in interface Query
    
    Parameters:
    name - parameter name
    
    Returns:
    parameter value
  - getParameterValue
```
public Object getParameterValue(int position)
```
    Description copied from interface: Query
    
    Return the value bound to the positional parameter.
    
    Specified by:
    
    getParameterValue in interface Query
    
    Parameters:
    position - position
    
    Returns:
    parameter value
  - setFlushMode
```
public Query setFlushMode(FlushModeType flushMode)
```
    Description copied from interface: Query
    
    Set the flush mode type to be used for the query execution. The flush mode type applies to the query regardless of the flush mode type in use for the entity manager.
    
    Specified by:
    
    setFlushMode in interface Query
    
    Parameters:
    flushMode - flush mode
    
    Returns:
    the same query instance
  - getFlushMode
```
public FlushModeType getFlushMode()
```
    Description copied from interface: Query
    
    Get the flush mode in effect for the query execution. If a flush mode has not been set for the query object, returns the flush mode in effect for the entity manager.
    
    Specified by:
    
    getFlushMode in interface Query
    
    Returns:
    flush mode
  - setLockMode
```
public Query setLockMode(LockModeType lockModeType)
```
    Description copied from interface: Query
    
    Set the lock mode type to be used for the query execution.
    
    Specified by:
    
    setLockMode in interface Query
    
    Parameters:
    lockModeType - lock mode
    
    Returns:
    the same query instance
  - getLockMode
```
public LockModeType getLockMode()
```
    Description copied from interface: Query
    
    Get the current lock mode for the query.
    
    Specified by:
    
    getLockMode in interface Query
    
    Returns:
    lock mode
  - unwrap
```
public <T> T unwrap(Class<T> type)
```
    Description copied from interface: Query
    
    Return an object of the specified type to allow access to the provider-specific API. If the provider's query implementation does not support the specified class, the PersistenceException is thrown.
    
    Specified by:
    
    unwrap in interface Query
    
    Parameters:
    type - the class of the object to be returned. This is normally either the underlying query implementation class or an interface that it implements.
    
    Returns:
    an instance of the specified class

Class FullTextQueryImpl

Field Summary

Fields inherited from interface org.hibernate.search.ProjectionConstants

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

FullTextQueryImpl

Method Detail

setSort

setFilter

getResultSize

setCriteriaQuery

setProjection

setSpatialParameters

setSpatialParameters

enableFullTextFilter

disableFullTextFilter

setResultTransformer

getResultList

getFacetManager

wrapLockException

getSingleResult

setMaxResults

getMaxResults

setFirstResult

getFirstResult

explain

limitExecutionTimeTo

hasPartialResults

initializeObjectsWith

executeUpdate

setHint

getHints

setParameter

setParameter

setParameter

setParameter

setParameter

setParameter

setParameter

setParameter

getParameters

setParameter

getParameter

getParameter

getParameter

getParameter

isBound

getParameterValue

getParameterValue

getParameterValue

setFlushMode

getFlushMode

setLockMode

getLockMode

unwrap