java.lang.Object
- org.apache.pdfbox.io.MemoryUsageSetting

```
public final class MemoryUsageSetting
extends java.lang.Object
```
Controls how memory/temporary files are used for buffering streams etc.

Field Summary

Fields
Modifier and Type	Field	Description
`private long`	`maxMainMemoryBytes`	maximum number of main-memory bytes allowed to be used; `-1` means 'unrestricted'
`private long`	`maxStorageBytes`	maximum number of bytes allowed for storage at all (main-memory+file); `-1` means 'unrestricted'
`RandomAccessStreamCache.StreamCacheCreateFunction`	`streamCache`	Implementation of the function to create an instance of ScratchFile using the current settings.
`private java.io.File`	`tempDir`	directory to be used for scratch file
`private boolean`	`useMainMemory`
`private boolean`	`useTempFile`

Constructor Summary

Constructors
Modifier	Constructor	Description
`private`	`MemoryUsageSetting(boolean useMainMemory, boolean useTempFile, long maxMainMemoryBytes, long maxStorageBytes)`	Private constructor for setup buffering memory usage called by one of the setup methods.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`long`	`getMaxMainMemoryBytes()`	Returns maximum size of main-memory in bytes to be used.
`long`	`getMaxStorageBytes()`	Returns maximum size of storage bytes to be used (main-memory in temporary files all together).
`java.io.File`	`getTempDir()`	Returns directory to be used for temporary files or `null` if it was not set.
`boolean`	`isMainMemoryRestricted()`	Returns `true` if maximum main memory is restricted to a specific number of bytes.
`boolean`	`isStorageRestricted()`	Returns `true` if maximum amount of storage is restricted to a specific number of bytes.
`MemoryUsageSetting`	`setTempDir(java.io.File tempDir)`	Sets directory to be used for temporary files.
`static MemoryUsageSetting`	`setupMainMemoryOnly()`	Setups buffering memory usage to only use main-memory (no temporary file) which is not restricted in size.
`static MemoryUsageSetting`	`setupMainMemoryOnly(long maxMainMemoryBytes)`	Setups buffering memory usage to only use main-memory with the defined maximum.
`static MemoryUsageSetting`	`setupMixed(long maxMainMemoryBytes)`	Setups buffering memory usage to use a portion of main-memory and additionally temporary file(s) in case the specified portion is exceeded.
`static MemoryUsageSetting`	`setupMixed(long maxMainMemoryBytes, long maxStorageBytes)`	Setups buffering memory usage to use a portion of main-memory and additionally temporary file(s) in case the specified portion is exceeded.
`static MemoryUsageSetting`	`setupTempFileOnly()`	Setups buffering memory usage to only use temporary file(s) (no main-memory) with not restricted size.
`static MemoryUsageSetting`	`setupTempFileOnly(long maxStorageBytes)`	Setups buffering memory usage to only use temporary file(s) (no main-memory) with the specified maximum size.
`java.lang.String`	`toString()`
`boolean`	`useMainMemory()`	Returns `true` if main-memory is to be used.
`boolean`	`useTempFile()`	Returns `true` if temporary file is to be used.

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

- Field Detail
  - useMainMemory
```
private final boolean useMainMemory
```
  - useTempFile
```
private final boolean useTempFile
```
  - maxMainMemoryBytes
```
private final long maxMainMemoryBytes
```
    maximum number of main-memory bytes allowed to be used; -1 means 'unrestricted'
  - maxStorageBytes
```
private final long maxStorageBytes
```
    maximum number of bytes allowed for storage at all (main-memory+file); -1 means 'unrestricted'
  - tempDir
```
private java.io.File tempDir
```
    directory to be used for scratch file
  - streamCache
```
public final RandomAccessStreamCache.StreamCacheCreateFunction streamCache
```
    Implementation of the function to create an instance of ScratchFile using the current settings.
- Constructor Detail
  - MemoryUsageSetting
```
private MemoryUsageSetting(boolean useMainMemory,
                           boolean useTempFile,
                           long maxMainMemoryBytes,
                           long maxStorageBytes)
```
    Private constructor for setup buffering memory usage called by one of the setup methods.
    
    Parameters:
    
    useMainMemory - if true main memory usage is enabled; in case of false and useTempFile is false too we set this to true
    
    useTempFile - if true using of temporary file(s) is enabled
    
    maxMainMemoryBytes - maximum number of main-memory to be used; if -1 means 'unrestricted'; if 0 we only use temporary file if useTempFile is true otherwise main-memory usage will have restriction defined by maxStorageBytes
    
    maxStorageBytes - maximum size the main-memory and temporary file(s) may have all together; 0 or less will be ignored; if it is less than maxMainMemoryBytes we use maxMainMemoryBytes value instead
- Method Detail
  - setupMainMemoryOnly
```
public static MemoryUsageSetting setupMainMemoryOnly()
```
    Setups buffering memory usage to only use main-memory (no temporary file) which is not restricted in size.
    
    Returns:
    
    returns an instance of MemoryUsageSetting set up to use unlimited memory
  - setupMainMemoryOnly
```
public static MemoryUsageSetting setupMainMemoryOnly(long maxMainMemoryBytes)
```
    Setups buffering memory usage to only use main-memory with the defined maximum.
    
    Parameters:
    
    maxMainMemoryBytes - maximum number of main-memory to be used; -1 for no restriction; 0 will also be interpreted here as no restriction
    
    Returns:
    
    returns an instance of MemoryUsageSetting set up to use main memory
  - setupTempFileOnly
```
public static MemoryUsageSetting setupTempFileOnly()
```
    Setups buffering memory usage to only use temporary file(s) (no main-memory) with not restricted size.
    
    Returns:
    
    returns an instance of MemoryUsageSetting set up to use temporary files with not restricted size
  - setupTempFileOnly
```
public static MemoryUsageSetting setupTempFileOnly(long maxStorageBytes)
```
    Setups buffering memory usage to only use temporary file(s) (no main-memory) with the specified maximum size.
    
    Parameters:
    
    maxStorageBytes - maximum size the temporary file(s) may have all together; -1 for no restriction; 0 will also be interpreted here as no restriction
    
    Returns:
    
    returns an instance of MemoryUsageSetting set up to use temporary files with restricted size
  - setupMixed
```
public static MemoryUsageSetting setupMixed(long maxMainMemoryBytes)
```
    Setups buffering memory usage to use a portion of main-memory and additionally temporary file(s) in case the specified portion is exceeded.
    
    Parameters:
    
    maxMainMemoryBytes - maximum number of main-memory to be used; if -1 this is the same as setupMainMemoryOnly(); if 0 this is the same as setupTempFileOnly()
    
    Returns:
    
    returns an instance of MemoryUsageSetting set up to use a mixed setting
  - setupMixed
```
public static MemoryUsageSetting setupMixed(long maxMainMemoryBytes,
                                            long maxStorageBytes)
```
    Setups buffering memory usage to use a portion of main-memory and additionally temporary file(s) in case the specified portion is exceeded.
    
    Parameters:
    
    maxMainMemoryBytes - maximum number of main-memory to be used; if -1 this is the same as setupMainMemoryOnly(); if 0 this is the same as setupTempFileOnly()
    
    maxStorageBytes - maximum size the main-memory and temporary file(s) may have all together; 0 or less will be ignored; if it is less than maxMainMemoryBytes we use maxMainMemoryBytes value instead
    
    Returns:
    
    returns an instance of MemoryUsageSetting set up to use a mixed setting
  - setTempDir
```
public MemoryUsageSetting setTempDir(java.io.File tempDir)
```
    Sets directory to be used for temporary files.
    
    Parameters:
    
    tempDir - directory for temporary files
    
    Returns:
    
    this instance
  - useMainMemory
```
public boolean useMainMemory()
```
    Returns true if main-memory is to be used.
    If this returns false it is ensured useTempFile() returns true.
    
    Returns:
    
    true if this instance is set up to use main memory
  - useTempFile
```
public boolean useTempFile()
```
    Returns true if temporary file is to be used.
    If this returns false it is ensured useMainMemory returns true.
    
    Returns:
    
    true if this instance is set up to use temporary files
  - isMainMemoryRestricted
```
public boolean isMainMemoryRestricted()
```
    Returns true if maximum main memory is restricted to a specific number of bytes.
    
    Returns:
    
    true if this instance is set up to restrict main memory
  - isStorageRestricted
```
public boolean isStorageRestricted()
```
    Returns true if maximum amount of storage is restricted to a specific number of bytes.
    
    Returns:
    
    true if this instance is set up to restrict storage size
  - getMaxMainMemoryBytes
```
public long getMaxMainMemoryBytes()
```
    Returns maximum size of main-memory in bytes to be used.
    
    Returns:
    
    the maximum number of main-memory in bytes to be used
  - getMaxStorageBytes
```
public long getMaxStorageBytes()
```
    Returns maximum size of storage bytes to be used (main-memory in temporary files all together).
    
    Returns:
    
    the maximum size of storage bytes to be used
  - getTempDir
```
public java.io.File getTempDir()
```
    Returns directory to be used for temporary files or null if it was not set.
    
    Returns:
    
    the temp dir to bes used for temporary files or null
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object

Class MemoryUsageSetting

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

useMainMemory

useTempFile

maxMainMemoryBytes

maxStorageBytes

tempDir

streamCache

Constructor Detail

MemoryUsageSetting

Method Detail

setupMainMemoryOnly

setupMainMemoryOnly

setupTempFileOnly

setupTempFileOnly

setupMixed

setupMixed

setTempDir

useMainMemory

useTempFile

isMainMemoryRestricted

isStorageRestricted

getMaxMainMemoryBytes

getMaxStorageBytes

getTempDir

toString