Deprecated API

Contents

• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Classes

Class and Description
org.apache.log4j.jmx.Agent
org.apache.pdfbox.pdmodel.encryption.PDEncryptionDictionary Use PDEncryption instead
org.apache.log4j.spi.RootCategory Replaced by RootLogger.

Deprecated Fields

Field and Description
org.apache.log4j.varia.StringMatchFilter.ACCEPT_ON_MATCH_OPTION Options are now handled using the JavaBeans paradigm. This constant is not longer needed and will be removed in the near term.
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.BOUNDARY_ART_BOX use PDViewerPreferences.BOUNDARY instead
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.BOUNDARY_BLEED_BOX use PDViewerPreferences.BOUNDARY instead
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.BOUNDARY_CROP_BOX use PDViewerPreferences.BOUNDARY instead
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.BOUNDARY_MEDIA_BOX use PDViewerPreferences.BOUNDARY instead
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.BOUNDARY_TRIM_BOX use PDViewerPreferences.BOUNDARY instead
org.apache.log4j.EnhancedPatternLayout.BUF_SIZE since 1.3
org.apache.log4j.spi.LoggingEvent.categoryName This field will be marked as private in future releases. Please do not access it directly. Use the LoggingEvent.getLoggerName() method instead.
org.apache.log4j.pattern.LogEvent.categoryName This field will be marked as private in future releases. Please do not access it directly. Use the LogEvent.getLoggerName() method instead.
org.apache.log4j.helpers.LogLog.CONFIG_DEBUG_KEY Use LogLog.DEBUG_KEY instead.
org.apache.log4j.LogManager.CONFIGURATOR_CLASS_KEY This variable is for internal use only. It will become private in future versions.
org.apache.log4j.helpers.DateLayout.DATE_FORMAT_OPTION Options are now handled using the JavaBeans paradigm. This constant is not longer needed and will be removed in the near term.
org.apache.log4j.Priority.DEBUG Use Level.DEBUG instead.
org.apache.log4j.LogManager.DEFAULT_CONFIGURATION_FILE This variable is for internal use only. It will become package protected in future versions.
org.apache.log4j.LogManager.DEFAULT_CONFIGURATION_KEY This variable is for internal use only. It will become private in future versions.
org.apache.log4j.LogManager.DEFAULT_INIT_OVERRIDE_KEY This variable is for internal use only. It will become private in future versions.
org.apache.log4j.Priority.ERROR Use Level.ERROR instead.
org.apache.log4j.Priority.FATAL Use Level.FATAL instead.
org.apache.log4j.Priority.INFO Use Level.INFO instead.
org.apache.log4j.spi.LoggingEvent.level This field will be marked as private in future releases. Please do not access it directly. Use the LoggingEvent.getLevel() method instead.
org.apache.log4j.pattern.LogEvent.level This field will be marked as private in future releases. Please do not access it directly. Use the LogEvent.getLevel() method instead.
org.apache.log4j.HTMLLayout.LOCATION_INFO_OPTION Options are now handled using the JavaBeans paradigm. This constant is not longer needed and will be removed in the near term.
org.apache.log4j.EnhancedPatternLayout.MAX_CAPACITY since 1.3
org.apache.log4j.spi.Filter.next As of 1.2.12, use Filter.getNext() and Filter.setNext(org.apache.log4j.spi.Filter) instead
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.NON_FULL_SCREEN_PAGE_MODE_USE_NONE use PDViewerPreferences.NON_FULL_SCREEN_PAGE_MODE instead
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.NON_FULL_SCREEN_PAGE_MODE_USE_OPTIONAL_CONTENT use PDViewerPreferences.NON_FULL_SCREEN_PAGE_MODE instead
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.NON_FULL_SCREEN_PAGE_MODE_USE_OUTLINES use PDViewerPreferences.NON_FULL_SCREEN_PAGE_MODE instead
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.NON_FULL_SCREEN_PAGE_MODE_USE_THUMBS use PDViewerPreferences.NON_FULL_SCREEN_PAGE_MODE instead
org.apache.pdfbox.cos.COSNumber.ONE Use the COSInteger.ONE constant instead
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.READING_DIRECTION_L2R use PDViewerPreferences.READING_DIRECTION instead
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.READING_DIRECTION_R2L use PDViewerPreferences.READING_DIRECTION instead
org.apache.log4j.varia.StringMatchFilter.STRING_TO_MATCH_OPTION Options are now handled using the JavaBeans paradigm. This constant is not longer needed and will be removed in the near term.
org.apache.log4j.helpers.DateLayout.TIMEZONE_OPTION Options are now handled using the JavaBeans paradigm. This constant is not longer needed and will be removed in the near term.
org.apache.log4j.Priority.WARN Use Level.WARN instead.
org.apache.pdfbox.cos.COSNumber.ZERO Use the COSInteger.ZERO constant instead

Deprecated Methods

Method and Description
org.apache.pdfbox.pdmodel.PDPageContentStream.addBezier31(float, float, float, float) Use PDPageContentStream.curveTo1(float, float, float, float) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.addBezier312(float, float, float, float, float, float) Use PDPageContentStream.curveTo(float, float, float, float, float, float) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.addBezier32(float, float, float, float) Use PDPageContentStream.curveTo2(float, float, float, float) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.addLine(float, float, float, float) Use PDPageContentStream.moveTo(float, float) followed by PDPageContentStream.lineTo(float, float).
org.apache.pdfbox.pdmodel.PDPageContentStream.addPolygon(float[], float[]) Use PDPageContentStream.moveTo(float, float) and PDPageContentStream.lineTo(float, float) methods instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.appendCOSName(COSName) This method will be removed in a future release.
org.apache.pdfbox.pdmodel.PDPageContentStream.appendRawCommands(byte[]) This method will be removed in a future release.
org.apache.pdfbox.pdmodel.PDPageContentStream.appendRawCommands(double) This method will be removed in a future release.
org.apache.pdfbox.pdmodel.PDPageContentStream.appendRawCommands(float) This method will be removed in a future release.
org.apache.pdfbox.pdmodel.PDPageContentStream.appendRawCommands(int) This method will be removed in a future release.
org.apache.pdfbox.pdmodel.PDPageContentStream.appendRawCommands(String) This method will be removed in a future release.
org.apache.pdfbox.pdmodel.PDPageContentStream.beginMarkedContentSequence(COSName) Use PDPageContentStream.beginMarkedContent(org.apache.pdfbox.cos.COSName) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.beginMarkedContentSequence(COSName, COSName) Use PDPageContentStream.beginMarkedContent(COSName, PDPropertyList) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.clipPath(int) Use PDPageContentStream.clip() or PDPageContentStream.clipEvenOdd() instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.closeSubPath() Use PDPageContentStream.closePath() instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.concatenate2CTM(AffineTransform) Use PDPageContentStream.transform(org.apache.pdfbox.util.Matrix) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.concatenate2CTM(double, double, double, double, double, double) Use PDPageContentStream.transform(org.apache.pdfbox.util.Matrix) instead.
org.apache.pdfbox.pdmodel.graphics.image.CCITTFactory.createFromRandomAccess(PDDocument, RandomAccess) Use CCITTFactory.createFromFile(PDDocument, File) instead.
org.apache.pdfbox.pdmodel.graphics.image.CCITTFactory.createFromRandomAccess(PDDocument, RandomAccess, int) Use CCITTFactory.createFromFile(PDDocument, File, int) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.drawInlineImage(PDInlineImage, float, float) Use PDPageContentStream.drawImage(PDInlineImage, float, float) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.drawInlineImage(PDInlineImage, float, float, float, float) Use PDPageContentStream.drawImage(PDInlineImage, float, float, float, float) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.drawLine(float, float, float, float) Use PDPageContentStream.moveTo(float, float) followed by PDPageContentStream.lineTo(float, float) followed by PDPageContentStream.stroke().
org.apache.pdfbox.pdmodel.PDPageContentStream.drawPolygon(float[], float[]) Use PDPageContentStream.moveTo(float, float) and PDPageContentStream.lineTo(float, float) methods instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.drawString(String) Use PDPageContentStream.showText(java.lang.String) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.drawXObject(PDXObject, AffineTransform) Use PDPageContentStream.drawImage(org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject, float, float) or PDPageContentStream.drawForm(org.apache.pdfbox.pdmodel.graphics.form.PDFormXObject) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.drawXObject(PDXObject, float, float, float, float) Use PDPageContentStream.drawImage(org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject, float, float) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.endMarkedContentSequence() Use PDPageContentStream.endMarkedContent() instead.
org.apache.pdfbox.pdmodel.common.function.PDFunction.eval(COSArray) Replaced by PDFunction.eval(float[] input)
org.apache.log4j.Category.exists(String) Please use LogManager.exists(java.lang.String) instead.
org.apache.pdfbox.util.Matrix.extractScaling() This method is due to be removed, please contact us if you make use of it.
org.apache.pdfbox.util.Matrix.extractTranslating() This method is due to be removed, please contact us if you make use of it.
org.apache.pdfbox.pdmodel.PDPageContentStream.fill(int) Use PDPageContentStream.fill() or PDPageContentStream.fillEvenOdd() instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.fillPolygon(float[], float[]) Use PDPageContentStream.moveTo(float, float) and PDPageContentStream.lineTo(float, float) methods instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.fillRect(float, float, float, float) Use PDPageContentStream.addRect(float, float, float, float) followed by PDPageContentStream.fill() instead.
org.apache.pdfbox.pdmodel.interactive.documentnavigation.destination.PDPageDestination.findPageNumber() This method has inconsistent behavior (see returns), use PDPageDestination.retrievePageNumber() instead.
org.apache.log4j.Priority.getAllPossiblePriorities() This method will be removed with no replacement.
org.apache.log4j.Category.getChainedPriority() Please use the the Category.getEffectiveLevel() method instead.
org.apache.log4j.Category.getCurrentCategories() Please use LogManager.getCurrentLoggers() instead.
org.apache.log4j.Hierarchy.getCurrentCategories() Please use Hierarchy.getCurrentLoggers() instead.
org.apache.log4j.Category.getDefaultHierarchy() Please use LogManager.getLoggerRepository() instead.
org.apache.log4j.Category.getHierarchy() Please use Category.getLoggerRepository() instead.
org.apache.log4j.varia.NullAppender.getInstance() Use getNullAppender instead. getInstance should have been static.
org.apache.log4j.Category.getInstance(Class) Please make sure to use Logger.getLogger(Class) instead.
org.apache.log4j.Category.getInstance(String) Make sure to use Logger.getLogger(String) instead.
org.apache.log4j.varia.StringMatchFilter.getOptionStrings() We now use JavaBeans introspection to configure components. Options strings are no longer needed.
org.apache.log4j.varia.DenyAllFilter.getOptionStrings() We now use JavaBeans introspection to configure components. Options strings are no longer needed.
org.apache.log4j.helpers.DateLayout.getOptionStrings() Use the setter method for the option directly instead of the generic setOption method.
org.apache.log4j.lf5.util.DateFormatManager.getOutputFormat() Use getPattern().
org.apache.log4j.Category.getPriority() Please use Category.getLevel() instead.
org.apache.log4j.helpers.Loader.getResource(String, Class) as of 1.2.
org.apache.log4j.Category.getRoot() Please use Logger.getRootLogger() instead.
org.apache.pdfbox.util.Matrix.getTranslatingInstance(float, float) Use Matrix.getTranslateInstance(float, float) instead.
org.apache.pdfbox.util.Matrix.getValuesAsDouble() Use Matrix.getValues() instead.
org.apache.pdfbox.pdmodel.interactive.form.PDTerminalField.getWidget() Fields may have more than one widget, call PDTerminalField.getWidgets() instead.
org.apache.pdfbox.util.Matrix.getXPosition() Use Matrix.getTranslateX() instead
org.apache.pdfbox.util.Matrix.getYPosition() Use Matrix.getTranslateY() instead
org.apache.pdfbox.pdmodel.font.PDTrueTypeFont.loadTTF(PDDocument, File) Use PDType0Font.load(PDDocument, File) instead.
org.apache.pdfbox.pdmodel.font.PDTrueTypeFont.loadTTF(PDDocument, InputStream) Use PDType0Font.load(PDDocument, InputStream) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.moveTextPositionByAmount(float, float) Use PDPageContentStream.newLineAtOffset(float, float) instead.
org.apache.log4j.Hierarchy.overrideAsNeeded(String) Deprecated with no replacement.
org.apache.pdfbox.contentstream.PDFStreamEngine.registerOperatorProcessor(String, OperatorProcessor) Use PDFStreamEngine.addOperator(OperatorProcessor) instead
org.apache.pdfbox.util.Matrix.reset() This method will be removed.
org.apache.log4j.lf5.viewer.categoryexplorer.CategoryNode.setAllDescendantsDeSelected()
org.apache.log4j.lf5.viewer.categoryexplorer.CategoryNode.setAllDescendantsSelected()
org.apache.log4j.Hierarchy.setDisableOverride(String) Deprecated with no replacement.
org.apache.pdfbox.util.Matrix.setFromAffineTransform(AffineTransform) Use the Matrix.Matrix(AffineTransform) constructor instead.
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.setNonFullScreenPageMode(String)
org.apache.pdfbox.pdmodel.PDPageContentStream.setNonStrokingColor(float[]) Use PDPageContentStream.setNonStrokingColor(PDColor) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.setNonStrokingColorSpace(PDColorSpace) Use PDPageContentStream.setNonStrokingColor(org.apache.pdfbox.pdmodel.graphics.color.PDColor) instead.
org.apache.pdfbox.pdmodel.graphics.color.PDICCBased.setNumberOfComponents(int)
org.apache.log4j.varia.StringMatchFilter.setOption(String, String) Use the setter method for the option directly instead of the generic setOption method.
org.apache.log4j.varia.DenyAllFilter.setOption(String, String) Use the setter method for the option directly instead of the generic setOption method.
org.apache.log4j.helpers.DateLayout.setOption(String, String) Use the setter method for the option directly instead of the generic setOption method.
org.apache.log4j.lf5.util.DateFormatManager.setOutputFormat(String) Use setPattern().
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.setPrintArea(String)
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.setPrintClip(String)
org.apache.log4j.Category.setPriority(Priority) Please use Category.setLevel(org.apache.log4j.Level) instead.
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.setReadingDirection(String)
org.apache.pdfbox.pdmodel.interactive.form.PDSignatureField.setSignature(PDSignature) Use PDSignatureField.setValue(PDSignature) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.setStrokingColor(float[]) Use PDPageContentStream.setStrokingColor(PDColor) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.setStrokingColor(int) Use PDPageContentStream.setStrokingColor(double) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.setStrokingColor(int, int, int, int) Use PDPageContentStream.setStrokingColor(float, float, float, float) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.setStrokingColorSpace(PDColorSpace) Use PDPageContentStream.setStrokingColor(org.apache.pdfbox.pdmodel.graphics.color.PDColor) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.setTextMatrix(AffineTransform) Use PDPageContentStream.setTextMatrix(Matrix) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.setTextMatrix(double, double, double, double, double, double) Use PDPageContentStream.setTextMatrix(Matrix) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.setTextRotation(double, double, double) Use PDPageContentStream.setTextMatrix(Matrix) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.setTextScaling(double, double, double, double) Use PDPageContentStream.setTextMatrix(Matrix) instead.
org.apache.pdfbox.pdmodel.PDPageContentStream.setTextTranslation(double, double) Use PDPageContentStream.setTextMatrix(Matrix) instead.
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.setViewArea(String)
org.apache.pdfbox.pdmodel.interactive.viewerpreferences.PDViewerPreferences.setViewClip(String)
org.apache.log4j.Category.shutdown() Please use LogManager.shutdown() instead.
org.apache.log4j.jmx.Agent.start()
org.apache.log4j.Priority.toPriority(int) Please use the Level.toLevel(int) method instead.
org.apache.log4j.Priority.toPriority(int, Priority) Please use the Level.toLevel(int, Level) method instead.
org.apache.log4j.Priority.toPriority(String) Please use the Level.toLevel(String) method instead.
org.apache.log4j.Priority.toPriority(String, Priority) Please use the Level.toLevel(String, Level) method instead.
org.apache.log4j.lf5.viewer.LogBrokerMonitor.trackTableScrollPane() tracking is now done automatically.

Deprecated Constructors

Constructor and Description
org.apache.log4j.jmx.Agent()
org.apache.pdfbox.pdmodel.encryption.PDEncryptionDictionary() Use PDEncryption instead
org.apache.pdfbox.pdmodel.encryption.PDEncryptionDictionary(COSDictionary) Use PDEncryption.PDEncryption(COSDictionary) instead