Interface AccessLog
-
- All Superinterfaces:
ConfigBeanProxy,PropertyBag
public interface AccessLog extends ConfigBeanProxy, PropertyBag
Access log configuration
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface org.jvnet.hk2.config.ConfigBeanProxy
ConfigBeanProxy.Duck
-
Nested classes/interfaces inherited from interface org.jvnet.hk2.config.types.PropertyBag
PropertyBag.Duck
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description StringgetBufferSizeBytes()Size in bytes of the buffer where access log calls are stored.StringgetCondition()Conditional logging filterStringgetDateStampToFirstAccessLogFileEnabled()Returns true if the first access log file and all subsequently rotated ones are supposed to be date-stamped, and false if datestamp is to be added only starting with the first rotation.StringgetFormat()Gets the value of the format attribute, which specifies the format of the access log.StringgetLogToConsoleEnabled()Specifies whether to display access logs on the console@NotNull StringgetMaxHistoryFiles()Gets the maximum number of rotated access log files that are to be kept.@NotNull StringgetMaximumFileSize()Gets the file size limit at which log will rotate.StringgetRotationEnabled()Gets the value of the rotation-enabled attribute.@Min(1L) @Max(2147483647L) StringgetRotationIntervalInMinutes()Gets the value of the rotation-interval-in-minutes attribute.StringgetRotationOnDateChange()StringgetRotationPolicy()Gets the value of the rotation-policy attribute.StringgetRotationSuffix()Gets the value of the rotation-suffix attribute.StringgetWriteIntervalSeconds()Number of seconds before the log is written to the disk.voidsetBufferSizeBytes(String value)voidsetCondition(String condition)Condition logging filtervoidsetDateStampToFirstAccessLogFileEnabled(String tf)Specifies whether date will be added to the first access log file or notvoidsetFormat(String value)Sets the value of the format attribute.voidsetLogToConsoleEnabled(boolean tf)specifies whether to display access logs to consolevoidsetMaxHistoryFiles(String value)Sets the maximum number of rotated access log files that are to be kept.voidsetMaximumFileSize(String value)Set size limit for log file at which it will rotate.voidsetRotationEnabled(String value)Sets the value of the rotation-enabled attribute.voidsetRotationIntervalInMinutes(String value)Sets the value of the rotation-interval-in-minutes attribute.voidsetRotationOnDateChange(String tf)voidsetRotationPolicy(String value)Sets the value of the rotation-policy attribute.voidsetRotationSuffix(String value)Sets the value of the rotation-suffix attribute.voidsetWriteIntervalSeconds(String value)-
Methods inherited from interface org.jvnet.hk2.config.ConfigBeanProxy
createChild, deepCopy, getParent, getParent
-
Methods inherited from interface org.jvnet.hk2.config.types.PropertyBag
addProperty, getProperty, getProperty, getPropertyValue, getPropertyValue, lookupProperty, removeProperty, removeProperty
-
-
-
-
Method Detail
-
getFormat
String getFormat()
Gets the value of the format attribute, which specifies the format of the access log.- Returns:
- possible object is
String
-
setFormat
void setFormat(String value) throws PropertyVetoException
Sets the value of the format attribute.- Parameters:
value- allowed object isString- Throws:
PropertyVetoException- if a listener vetoes the change
-
getRotationPolicy
String getRotationPolicy()
Gets the value of the rotation-policy attribute.- Returns:
- possible object is
String
-
setRotationPolicy
void setRotationPolicy(String value) throws PropertyVetoException
Sets the value of the rotation-policy attribute.- Parameters:
value- allowed object isString- Throws:
PropertyVetoException- if a listener vetoes the change
-
getRotationIntervalInMinutes
@Min(1L) @Max(2147483647L) @Min(1L) @Max(2147483647L) String getRotationIntervalInMinutes()
Gets the value of the rotation-interval-in-minutes attribute. The time interval in minutes between two successive rotations of the access logs.- Returns:
- possible object is
String
-
setRotationIntervalInMinutes
void setRotationIntervalInMinutes(String value) throws PropertyVetoException
Sets the value of the rotation-interval-in-minutes attribute.- Parameters:
value- allowed object isString- Throws:
PropertyVetoException- if a listener vetoes the change
-
getRotationSuffix
String getRotationSuffix()
Gets the value of the rotation-suffix attribute. The suffix to be added to the access-log name after rotation. Acceptable values include those supported by java.text.SimpleDateFormat and "%YYYY;%MM;%DD;-%hh;h%mm;m%ss;s".- Returns:
- possible object is
String
-
setRotationSuffix
void setRotationSuffix(String value) throws PropertyVetoException
Sets the value of the rotation-suffix attribute.- Parameters:
value- allowed object isString- Throws:
PropertyVetoException- if a listener vetoes the change
-
getRotationEnabled
String getRotationEnabled()
Gets the value of the rotation-enabled attribute. The flag for enabling the access-log rotation- Returns:
- possible object is
String
-
setRotationEnabled
void setRotationEnabled(String value) throws PropertyVetoException
Sets the value of the rotation-enabled attribute.- Parameters:
value- allowed object isString- Throws:
PropertyVetoException- if a listener vetoes the change
-
getRotationOnDateChange
String getRotationOnDateChange()
-
setRotationOnDateChange
void setRotationOnDateChange(String tf) throws PropertyVetoException
- Throws:
PropertyVetoException
-
getBufferSizeBytes
String getBufferSizeBytes()
Size in bytes of the buffer where access log calls are stored. If the value is less than 5120, a warning message is issued, and the value is set to 5120- Returns:
- the buffer-size
-
setBufferSizeBytes
void setBufferSizeBytes(String value)
-
getWriteIntervalSeconds
String getWriteIntervalSeconds()
Number of seconds before the log is written to the disk. The access log is written when the buffer is full or when the interval expires. If the value is 0, the buffer is always written even if it is not full. This means that each time the server is accessed, the log message is stored directly to the file- Returns:
- the write interval in seconds
-
setWriteIntervalSeconds
void setWriteIntervalSeconds(String value)
-
getMaxHistoryFiles
@NotNull @NotNull String getMaxHistoryFiles()
Gets the maximum number of rotated access log files that are to be kept.A negative value must be interpreted as no limit.
- Returns:
- the max number of log files
-
setMaxHistoryFiles
void setMaxHistoryFiles(String value) throws PropertyVetoException
Sets the maximum number of rotated access log files that are to be kept.- Parameters:
value- the maximum number of log files- Throws:
PropertyVetoException- if a listener vetoes the change
-
getMaximumFileSize
@NotNull @NotNull String getMaximumFileSize()
Gets the file size limit at which log will rotate.A value of 0 will disable log rotation based on file size
- Returns:
- log file size rotation limit
-
setMaximumFileSize
void setMaximumFileSize(String value) throws PropertyVetoException
Set size limit for log file at which it will rotate.- Parameters:
value- the limit for log file size- Throws:
PropertyVetoException- if a listener vetoes the change
-
getLogToConsoleEnabled
String getLogToConsoleEnabled()
Specifies whether to display access logs on the console- Returns:
- true if logging to console
-
setLogToConsoleEnabled
void setLogToConsoleEnabled(boolean tf)
specifies whether to display access logs to console- Parameters:
tf- true/false
-
getCondition
String getCondition()
Conditional logging filter- Returns:
- the condition filter for the log
-
setCondition
void setCondition(String condition)
Condition logging filter- Parameters:
condition- the condition filter for the log
-
getDateStampToFirstAccessLogFileEnabled
String getDateStampToFirstAccessLogFileEnabled()
Returns true if the first access log file and all subsequently rotated ones are supposed to be date-stamped, and false if datestamp is to be added only starting with the first rotation.- Returns:
- true if first access log file and all subsequently rotated ones are supposed to be date-stamped, and false if datestamp is to be added only starting with the first rotation.
-
setDateStampToFirstAccessLogFileEnabled
void setDateStampToFirstAccessLogFileEnabled(String tf) throws PropertyVetoException
Specifies whether date will be added to the first access log file or not- Parameters:
tf- true/false- Throws:
PropertyVetoException- if a listener vetoes the change
-
-