java.lang.Object
- com.exedio.cope.Feature
- - com.exedio.cope.Pattern
  - - com.exedio.cope.pattern.MediaPath
    - - com.exedio.cope.pattern.Media

All Implemented Interfaces:

Copyable, Settable<Media.Value>, Serializable
```
public final class Media
extends MediaPath
implements Settable<Media.Value>, Copyable
```
See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class Description

static class Media.Value
- Nested classes/interfaces inherited from class com.exedio.cope.pattern.MediaPath
  MediaPath.Locator, MediaPath.Log, MediaPath.NotFound

Field Summary

Fields
Modifier and Type Field Description

static long DEFAULT_LENGTH

Constructor Summary

Constructors
Constructor	Description
`Media()`
`Media(String fixedMimeMajor)`	Deprecated. use `contentTypeSub(String)` instead.
`Media(String fixedMimeMajor, String fixedMimeMinor)`	Deprecated. use `contentType(String)` instead.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`Condition`	`bodyMismatchesContentType()`	Deprecated. Use `bodyMismatchesContentTypeIfSupported()` instead.
`Condition`	`bodyMismatchesContentTypeIfSupported()`	The result may cause an `UnsupportedQueryException` when used, if the field is stored in a `vault`.
`boolean`	`checkContentType(String contentType)`
`Media`	`contentType(String contentType)`	Creates a new media, that must contain the given content type only.
`Media`	`contentType(String contentType1, String contentType2)`	Creates a new media, that must contain one of the given content types only.
`Media`	`contentType(String contentType1, String contentType2, String contentType3)`	Creates a new media, that must contain one of the given content types only.
`Media`	`contentType(String contentType1, String contentType2, String contentType3, String contentType4)`	Creates a new media, that must contain one of the given content types only.
`Media`	`contentType(String contentType1, String contentType2, String contentType3, String contentType4, String contentType5)`	Creates a new media, that must contain one of the given content types only.
`Media`	`contentType(String contentType1, String contentType2, String contentType3, String contentType4, String contentType5, String contentType6)`	Creates a new media, that must contain one of the given content types only.
`Media`	`contentType(String contentType1, String contentType2, String contentType3, String contentType4, String contentType5, String contentType6, String contentType7)`	Creates a new media, that must contain one of the given content types only.
`Media`	`contentType(String contentType1, String contentType2, String contentType3, String contentType4, String contentType5, String contentType6, String contentType7, String contentType8)`	Creates a new media, that must contain one of the given content types only.
`Media`	`contentType(String contentType1, String contentType2, String contentType3, String contentType4, String contentType5, String contentType6, String contentType7, String contentType8, String contentType9)`	Creates a new media, that must contain one of the given content types only.
`Media`	`contentType(String contentType1, String contentType2, String contentType3, String contentType4, String contentType5, String contentType6, String contentType7, String contentType8, String contentType9, String contentType10)`	Creates a new media, that must contain one of the given content types only.
`Condition`	`contentTypeEqual(String contentType)`
`Media`	`contentTypeLengthMax(int maximumLength)`
`Media`	`contentTypeMajor(String majorContentType)`	Deprecated. Use `contentTypeSub(String)` instead
`Media`	`contentTypeSub(String majorContentType)`	Creates a new media, that must contain the a content type with the given major part only.
`Media`	`copy(CopyMapper mapper)`
`void`	`doGetAndCommit(HttpServletRequest request, HttpServletResponse response, Item item)`	The implementor MUST `commit` the transaction, if the method completes normally (without exception).
`SetValue<?>[]`	`execute(Media.Value value, Item exceptionItem)`
`static Media`	`get(DataField field)`
`DataField`	`getBody()`
`byte[]`	`getBody(Item item)`	Returns the body of this media.
`void`	`getBody(Item item, File body)`	Writes the body of this media into the given file.
`void`	`getBody(Item item, OutputStream body)`	Writes the body of this media into the given steam.
`void`	`getBody(Item item, Path body)`
`FunctionField<?>`	`getContentType()`
`String`	`getContentType(Item item)`	Returns the content type of this media.
`String`	`getContentTypeDescription()`
`int`	`getContentTypeMaximumLength()`
`List<String>`	`getContentTypesAllowed()`	Returns a list of content types allowed for this media.
`Set<Class<? extends Throwable>>`	`getInitialExceptions()`	Returns the exceptions possibly thrown, when setting a value for this settable.
`Class<?>`	`getInitialType()`
`DateField`	`getLastModified()`
`Date`	`getLastModified(Item item)`	Returns the date of the last modification of this media.
`long`	`getLength(Item item)`	Returns the length of the body of this media.
`long`	`getMaximumLength()`
`CheckConstraint`	`getUnison()`
`boolean`	`isAnnotatedVault()`
`boolean`	`isContentTypeWrapped()`
`boolean`	`isFinal()`	Returns, whether the contents of this media path may change or not.
`boolean`	`isInitial()`	Returns true, if a value for the settable should be specified on the creation of an item.
`boolean`	`isMandatory()`	A MediaPath is "mandatory" if `MediaPath.getContentType(Item)` and `MediaPath.getLocator(Item)` will not return `null` for any item.
`Condition`	`isNotNull()`	Returns a condition matching all items, for which `MediaPath.getLocator(Item)` does not return null.
`Condition`	`isNotNull(Join join)`	Returns a condition matching all items, for which `MediaPath.getLocator(Item)` does not return null.
`Condition`	`isNull()`	Returns a condition matching all items, for which `MediaPath.getLocator(Item)` returns null.
`boolean`	`isNull(Item item)`
`Condition`	`isNull(Join join)`	Returns a condition matching all items, for which `MediaPath.getLocator(Item)` returns null.
`Media`	`lengthMax(long maximumLength)`
`Media`	`optional()`
`void`	`set(Item item, byte[] body, String contentType)`	Sets the contents of this media.
`void`	`set(Item item, Media.Value value)`	Sets the contents of this media.
`void`	`set(Item item, File body, String contentType)`	Sets the contents of this media.
`void`	`set(Item item, InputStream body, String contentType)`	Sets the contents of this media.
`void`	`set(Item item, Path body, String contentType)`
`void`	`setLastModified(Item item, Date value)`
`Media`	`toFinal()`
`static Media.Value`	`toValue(byte[] body, String contentType)`
`static Media.Value`	`toValue(DataField.Value body, String contentType)`
`static Media.Value`	`toValue(File body, String contentType)`
`static Media.Value`	`toValue(InputStream body, String contentType)`
`static Media.Value`	`toValue(Path body, String contentType)`

Methods inherited from class com.exedio.cope.pattern.MediaPath
commit, getExceptionLogs, getGuessedUrlLogs, getInfo, getInvalidSpecialLogs, getIsNullLogs, getLocator, getNamedURL, getNoSuchItemLogs, getNoSuchPath, getNoSuchPathLogs, getNotAnItemLogs, getNotComputableLogs, getURL, incrementDelivered, isUrlFingerPrinted, isUrlGuessingPrevented, isUrlGuessingPreventedSecurely, notFoundIsNull, notFoundNotComputable, onMount

Methods inherited from class com.exedio.cope.Pattern
addSource, addSource, addSource, addSource, addSourceFeature, addSourceFeature, addSourceFeature, annotationField, equals, getGeneratedTypes, getSourceFeatures, getSourceFeaturesGather, getSourceFields, getSources, getSourceTypes, getType, hashCode, initialize, newSourceType, newSourceType, newSourceType, newSourceType, newSourceType, newSourceType, newType, newType, registerSource

Methods inherited from class com.exedio.cope.Feature
afterModelCreated, getAbstractType, getAnnotation, getID, getLocalizationKeys, getName, getPattern, isAnnotationPresent, isSourceAlready, mount, readResolve, requireMounted, toString, toString, writeReplace

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

Methods inherited from interface com.exedio.cope.Settable
map

Field Detail
- DEFAULT_LENGTH
```
public static final long DEFAULT_LENGTH
```
  See Also:
  
  Constant Field Values

Constructor Detail

Media
```
public Media()
```

Media

@Deprecated
public Media(String fixedMimeMajor,
             String fixedMimeMinor)

Deprecated.

use contentType(String) instead.

Media

@Deprecated
public Media(String fixedMimeMajor)

Deprecated.

use contentTypeSub(String) instead.

Method Detail

copy

public Media copy(CopyMapper mapper)

Specified by:: copy in interface Copyable

toFinal
```
public Media toFinal()
```

optional
```
public Media optional()
```

lengthMax

public Media lengthMax(long maximumLength)

contentType
```
public Media contentType(String contentType)
```
Creates a new media, that must contain the given content type only.