Deprecated List (iText 7 7.1.12 API)

Deprecated Interfaces
Interface and Description
com.itextpdf.kernel.log.ICounter will be removed in next major release, please use `EventCounter` instead.
com.itextpdf.kernel.log.ICounterFactory will be removed in next major release, please use `IEventCounterFactory` instead.
com.itextpdf.svg.renderers.factories.ISvgNodeRendererMapper The interface will be removed in 7.2, while its implementation (`DefaultSvgNodeRendererMapper`) will be used as our internal class. Users should override `ISvgNodeRendererFactory` (or at least `DefaultSvgNodeRendererFactory`) and should not deal with the mapping class as it's more of an implementation detail.
com.itextpdf.svg.renderers.impl.ISvgTextNodeHelper

Deprecated Classes
Class and Description
com.itextpdf.kernel.log.CounterManager will be removed in next major release, please use `EventCounterHandler` instead.
com.itextpdf.kernel.log.DefaultCounter will be removed in next major release, please use `DefaultEventCounter` instead.
com.itextpdf.svg.renderers.factories.DefaultSvgNodeRendererMapper The public access to this class will be removed in 7.2. The class itself can become either package private or the inner private static class for the `DefaultSvgNodeRendererFactory`. Users should override `ISvgNodeRendererFactory` (or at least `DefaultSvgNodeRendererFactory`) and should not deal with the mapping class as it's more of an implementation detail.
com.itextpdf.io.font.FontConstants Use constants from com.itextpdf.io.font.constants.
com.itextpdf.layout.font.FontFamilySplitter will be moved to styled-xml-parser module in iText 7.2.
com.itextpdf.kernel.pdf.annot.PdfRichMediaAnnotation Remove this class in 7.2. The deprecation relates to the fact that the prototype hasn't been implemented in a full yet and we do not expect the situation to change.
com.itextpdf.io.source.PdfTokenizer.ReusableRandomAccessSource Will be removed in 7.2. This inner class is not used anywhere
com.itextpdf.kernel.log.SimpleCounterFactory will be removed in next major release, please use `SimpleEventCounterFactory` instead.
com.itextpdf.svg.css.impl.StyleResolverUtil use `StyleUtil` instead. Utility class for resolving parent-inheritance of style and attribute declarations
com.itextpdf.kernel.log.SystemOutCounter will be removed in the next major release, please use `SystemOutEventCounter` instead.
com.itextpdf.kernel.log.SystemOutCounterFactory will be removed in the next major release, please use `SystemOutEventCounterFactory` instead.

Deprecated Enums
Enum and Description
com.itextpdf.forms.xfdf.Encoding use `ElementContentEncodingFormat` instead

Deprecated Fields
Field and Description
com.itextpdf.forms.xfdf.XfdfConstants.ATTRIBUTE_NAME_OR_VALUE_MISSING Use `XfdfException.ATTRIBUTE_NAME_OR_VALUE_MISSING` instead. The constant will be removed in 7.2.
com.itextpdf.io.font.FontConstants.BOLD use `FontStyles.BOLD` instead.
com.itextpdf.io.font.FontConstants.BOLDITALIC use `FontStyles.BOLDITALIC` instead.
com.itextpdf.layout.Document.bottomMargin To be removed in 7.2. Use `Property.MARGIN_BOTTOM` instead.
com.itextpdf.kernel.PdfException.CannotSetDataToPdfstreamWhichWasCreatedByInputStream
com.itextpdf.io.font.FontConstants.COURIER use `StandardFonts.COURIER` instead.
com.itextpdf.io.font.FontConstants.COURIER_BOLD use `StandardFonts.COURIER_BOLD` instead.
com.itextpdf.io.font.FontConstants.COURIER_BOLDOBLIQUE use `StandardFonts.COURIER_BOLDOBLIQUE` instead.
com.itextpdf.io.font.FontConstants.COURIER_OBLIQUE use `StandardFonts.COURIER_OBLIQUE` instead.
com.itextpdf.kernel.pdf.PdfDocument.currentPage Will be removed in iText 7.2
com.itextpdf.forms.fields.PdfFormField.DA_COLOR Will be made package-private in iText 7.2.
com.itextpdf.forms.fields.PdfFormField.DA_FONT Will be made package-private in iText 7.2.
com.itextpdf.forms.fields.PdfFormField.DA_SIZE Will be made package-private in iText 7.2.
com.itextpdf.forms.fields.PdfFormField.DEFAULT_FONT_SIZE Will be made package-private in iText 7.2.
com.itextpdf.svg.exceptions.SvgLogMessageConstant.ERROR_CLOSING_CSS_STREAM
com.itextpdf.io.LogMessageConstant.FAILED_TO_PROCESS_A_TRANSFORMATION_MATRIX Moved into cleanup module The constant will be removed in 7.2.
com.itextpdf.svg.exceptions.SvgLogMessageConstant.FLOAT_PARSING_NAN
com.itextpdf.svg.exceptions.SvgLogMessageConstant.FONT_PROVIDER_CONTAINS_ZERO_FONTS
com.itextpdf.kernel.PdfException.FontSizeIsTooSmall
com.itextpdf.kernel.PdfException.GivenAccessibleElementIsNotConnectedToAnyTag
com.itextpdf.io.font.FontConstants.HELVETICA use `StandardFonts.HELVETICA` instead.
com.itextpdf.io.font.FontConstants.HELVETICA_BOLD use `StandardFonts.HELVETICA_BOLD` instead.
com.itextpdf.io.font.FontConstants.HELVETICA_BOLDOBLIQUE use `StandardFonts.HELVETICA_BOLDOBLIQUE` instead.
com.itextpdf.io.font.FontConstants.HELVETICA_OBLIQUE use `StandardFonts.HELVETICA_OBLIQUE` instead.
com.itextpdf.pdfa.PdfAConformanceException.IF_THE_DOCUMENT_DOES_NOT_CONTAIN_A_PDFA_OUTPUTINTENT_TRANSPARENCY_IS_FORBIDDEN
com.itextpdf.io.LogMessageConstant.IMAGE_MASK_CLEAN_UP_NOT_SUPPORTED Moved into cleanup module The constant will be removed in 7.2.
com.itextpdf.io.font.FontConstants.ITALIC use `FontStyles.ITALIC` instead.
com.itextpdf.layout.Document.leftMargin To be removed in 7.2. Use `Property.MARGIN_LEFT` instead.
com.itextpdf.forms.fields.PdfFormField.MIN_FONT_SIZE Will be made package-private in iText 7.2.
com.itextpdf.styledxmlparser.LogMessageConstant.NAN moved into `StyledXMLParserException`
com.itextpdf.kernel.PdfException.NoMaxLenPresent Now we log a warning rather than throw an exception.
com.itextpdf.io.font.FontConstants.NORMAL use `FontStyles.NORMAL` instead.
com.itextpdf.layout.property.Property.OVERFLOW Use `Property.OVERFLOW_X` and/or `Property.OVERFLOW_Y` instead. The `Property.OVERFLOW` property doesn't have any affect and will be removed in iText 7.2
com.itextpdf.forms.xfdf.XfdfConstants.PAGE_IS_MISSING Use `XfdfException.PAGE_IS_MISSING` instead. The constant will be removed in 7.2.
com.itextpdf.kernel.pdf.annot.PdfPolyGeomAnnotation.Polygon , use `PdfName.Polygon` instead.
com.itextpdf.kernel.pdf.annot.PdfPolyGeomAnnotation.PolyLine , use `PdfName.PolyLine` instead.
com.itextpdf.layout.renderer.ParagraphRenderer.previousDescent
com.itextpdf.io.LogMessageConstant.REDACTION_OF_ANNOTATION_TYPE_WATERMARK_IS_NOT_SUPPORTED Moved into cleanup module The constant will be removed in 7.2.
com.itextpdf.layout.Document.rightMargin To be removed in 7.2. Use `Property.MARGIN_RIGHT` instead.
com.itextpdf.svg.SvgConstants.Values.SVGNAMESPACEURL
com.itextpdf.io.font.FontConstants.SYMBOL use `StandardFonts.SYMBOL` instead.
com.itextpdf.layout.font.FontSelectorStrategy.tempFonts This field will be renamed to `additionalFonts` in iText Core 7.2.
com.itextpdf.io.font.FontConstants.TIMES_BOLD use `StandardFonts.TIMES_BOLD` instead.
com.itextpdf.io.font.FontConstants.TIMES_BOLDITALIC use `StandardFonts.TIMES_BOLDITALIC` instead.
com.itextpdf.io.font.FontConstants.TIMES_ITALIC use `StandardFonts.TIMES_ITALIC` instead.
com.itextpdf.io.font.FontConstants.TIMES_ROMAN use `StandardFonts.TIMES_ROMAN` instead.
com.itextpdf.layout.Document.topMargin To be removed in 7.2. Use `Property.MARGIN_TOP` instead.
com.itextpdf.svg.exceptions.SvgLogMessageConstant.TRANSFORM_INCORRECT_VALUE_TYPE
com.itextpdf.io.font.FontConstants.UNDEFINED use `FontStyles.UNDEFINED` instead.
com.itextpdf.forms.xfdf.XfdfConstants.UNSUPPORTED_ANNOTATION_ATTRIBUTE Use `LogMessageConstant.XFDF_UNSUPPORTED_ANNOTATION_ATTRIBUTE` instead. The constant will be removed in 7.2.
com.itextpdf.kernel.PdfException.UnsupportedDefaultColorSpaceName1
com.itextpdf.kernel.PdfException.WrongMediaBoxSize1 in favour of more informative named constant
com.itextpdf.forms.fields.PdfFormField.X_OFFSET Will be made package-private in iText 7.2.
com.itextpdf.io.LogMessageConstant.XREF_ERROR Use `LogMessageConstant.XREF_ERROR_WHILE_READING_TABLE_WILL_BE_REBUILT` instead. The constant will be removed in 7.2.
com.itextpdf.io.font.FontConstants.ZAPFDINGBATS use `StandardFonts.ZAPFDINGBATS` instead.

Deprecated Methods
Method and Description
com.itextpdf.kernel.font.PdfTrueTypeFont.addRangeUni(Set) use `TrueTypeFont.updateUsedGlyphs(SortedSet, boolean, List)`
com.itextpdf.kernel.font.PdfType0Font.addRangeUni(TrueTypeFont, Map, boolean) will be removed in 7.2
com.itextpdf.kernel.font.PdfType0Font.addRangeUni(TrueTypeFont, Set) use `TrueTypeFont.updateUsedGlyphs(SortedSet, boolean, List)` instead.
com.itextpdf.kernel.pdf.canvas.parser.clipper.ClipperBridge.addRectToClipper(IClipper, Point[], IClipper.PolyType) use `ClipperBridge.addPolygonToClipper(com.itextpdf.kernel.pdf.canvas.parser.clipper.IClipper, com.itextpdf.kernel.geom.Point[], com.itextpdf.kernel.pdf.canvas.parser.clipper.IClipper.PolyType)` instead.
com.itextpdf.svg.utils.DrawUtils.arc(float, float, float, float, float, float, PdfCanvas) In `PdfCanvas` most of the path drawing methods accept `double`. So it is preferable to use `DrawUtils.arc(double, double, double, double, double, double, PdfCanvas)`. This method will be removed in iText 7.2
com.itextpdf.signatures.SignatureUtil.asLongArray(PdfArray) Will be removed in 7.2. Use `PdfArray.toLongArray()` instead
com.itextpdf.pdfa.checker.PdfAChecker.checkColor(Color, PdfDictionary, Boolean) This method will be replaced by `checkColor` in 7.2 release
com.itextpdf.pdfa.checker.PdfAChecker.checkExtGState(CanvasGraphicsState) This method will be replaced by `checkExtGState` in 7.2 release
com.itextpdf.kernel.pdf.PdfDocument.checkIsoConformance(Object, IsoKey, PdfResources) This method will be replaced by `checkIsoConformance` in 7.2 release
com.itextpdf.pdfa.PdfADocument.checkIsoConformance(Object, IsoKey, PdfResources)
com.itextpdf.kernel.font.PdfFont.compactRanges(List) The logic has been moved to `TrueTypeFont`.
com.itextpdf.svg.utils.SvgCssUtils.convertPtsToPx(double) Will be replaced by the `CssUtils.convertPtsToPx(double)` in update 7.2.
com.itextpdf.svg.utils.SvgCssUtils.convertPtsToPx(float) Will be replaced by the `CssUtils.convertPtsToPx(float)` in update 7.2.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.create(int, PdfName, float, float, float, float, float) Use `PdfExplicitRemoteGoToDestination.create(int, PdfName, float, float, float, float, float)` instead.
com.itextpdf.io.image.ImageDataFactory.createBmp(byte[], boolean, int) will be removed in 7.2
com.itextpdf.io.image.ImageDataFactory.createBmp(URL, boolean, int) will be removed in 7.2
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createFit(int) Use `PdfExplicitRemoteGoToDestination.createFit(int)` instead.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createFitB(int) Use `PdfExplicitRemoteGoToDestination.createFitB(int)` instead.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createFitBH(int, float) Use `PdfExplicitRemoteGoToDestination.createFitBH(int, float)` instead.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createFitBV(int, float) Use `PdfExplicitRemoteGoToDestination.createFitBV(int, float)` instead.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createFitH(int, float) Use `PdfExplicitRemoteGoToDestination.createFitH(int, float)` instead.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createFitR(int, float, float, float, float) Use `PdfExplicitRemoteGoToDestination.createFitR(int, float, float, float, float)` instead.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createFitV(int, float) Use `PdfExplicitRemoteGoToDestination.createFitV(int, float)` instead.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createXYZ(int, float, float, float) Use `PdfExplicitRemoteGoToDestination.createXYZ(int, float, float, float)` instead.
com.itextpdf.forms.fields.PdfFormField.drawMultiLineTextAppearance(Rectangle, PdfFont, float, String, PdfFormXObject) use `PdfFormField.drawMultiLineTextAppearance(Rectangle, PdfFont, String, PdfFormXObject)` instead.
com.itextpdf.forms.fields.PdfFormField.drawPdfA1CheckAppearance(float, float, String, int) use `PdfFormField.drawPdfA2CheckAppearance(float, float, String, int)` instead.
com.itextpdf.forms.fields.PdfFormField.drawPdfA1RadioAppearance(float, float, String) Please, use `PdfFormField.drawRadioAppearance(float, float, String)` instead.
com.itextpdf.forms.fields.PdfFormField.drawPushButtonAppearance(float, float, String, PdfFont, PdfName, float) use `PdfFormField.drawPushButtonAppearance(float, float, String, PdfFont, float)` instead.
com.itextpdf.forms.fields.PdfFormField.generateDefaultAppearanceString(PdfFont, float, Color, PdfResources) use `PdfFormField.updateDefaultAppearance()` instead.
com.itextpdf.signatures.PdfPKCS7.getAuthenticatedAttributeBytes(byte[], byte[], Collection, PdfSigner.CryptoStandard) This method overload is deprecated. Please use `PdfPKCS7.getAuthenticatedAttributeBytes(byte[], PdfSigner.CryptoStandard, Collection, Collection)`
com.itextpdf.kernel.font.PdfType0Font.getCidFontType2(TrueTypeFont, PdfDictionary, String, int[]) use `PdfType0Font.getCidFont(PdfDictionary, String, boolean)` instead.
com.itextpdf.kernel.font.PdfType0Font.getCidFontType2(TrueTypeFont, PdfDictionary, String, int[][]) will be removed in 7.2
com.itextpdf.io.font.CMapEncoding.getCmapCode(int) Will be removed in 7.2. Use `CMapEncoding.getCmapBytes(int)` instead.
com.itextpdf.kernel.pdf.PdfDocument.getCounters()
com.itextpdf.pdfa.PdfADocument.getCounters()
com.itextpdf.layout.borders.RoundDotsBorder.getDotsGap(double, float) logic moved to super-class
com.itextpdf.layout.borders.DottedBorder.getDotsGap(double, float) logic moved to super-class
com.itextpdf.layout.borders.DashedBorder.getDotsGap(double, float) logic moved to super-class
com.itextpdf.signatures.PdfPKCS7.getEncodedPKCS7(byte[], ITSAClient, byte[], Collection, PdfSigner.CryptoStandard) This overload is deprecated, use `PdfPKCS7.getEncodedPKCS7(byte[], PdfSigner.CryptoStandard, ITSAClient, Collection, Collection)` instead.
com.itextpdf.forms.fields.PdfFormField.getFontAndSize(PdfDictionary) use `PdfFormField.getFont()` and `PdfFormField.getFontSize()` instead.
com.itextpdf.layout.renderer.TableRenderer.getLastYLineRecursively() Will be removed in next major release (iText 7.2). The aim of this method overriding here is achieved by overriding `TableRenderer.allowLastYLineRecursiveExtraction()` method.
com.itextpdf.svg.renderers.impl.AbstractSvgNodeRenderer.getObjectBoundingBox(SvgDrawContext)
com.itextpdf.io.image.BmpImageData.getSize() will be removed in 7.2
com.itextpdf.kernel.font.PdfType0Font.getToUnicode(Object[]) will be removed in 7.2. Use `PdfType0Font.getToUnicode()` instead
com.itextpdf.kernel.pdf.collection.PdfCollection.getView() Will always return null. The return will be changed to PdfName in 7.2. Use `getPdfObject().getAsName(PdfName.View)`, or one of `PdfCollection.isViewDetails()`, `PdfCollection.isViewTile()`, `PdfCollection.isViewHidden()`.
com.itextpdf.kernel.pdf.filters.FlateDecodeFilter.isStrictDecoding() will be removed in 7.2, use `FlateDecodeStrictFilter` instead.
com.itextpdf.signatures.OCSPVerifier.isValidResponse(BasicOCSPResp, X509Certificate) Will be removed in iText 7.2. Use `OCSPVerifier.isValidResponse(BasicOCSPResp, X509Certificate, Date)` instead
com.itextpdf.kernel.pdf.canvas.PdfCanvas.newPath() in favour of endPath(), which does exactly the same thing but is better named
com.itextpdf.svg.converter.SvgConverter.process(INode) will be removed in iText 7.2.
com.itextpdf.svg.processors.impl.DefaultSvgProcessor.process(INode)
com.itextpdf.styledxmlparser.resolver.resource.ResourceResolver.retrieveImage(String) will return `in pdfHTML 3.0.0`
com.itextpdf.styledxmlparser.resolver.resource.ResourceResolver.retrieveStream(String)
com.itextpdf.forms.fields.PdfFormField.setDefaultAppearance(String) use `PdfFormField.updateDefaultAppearance()` instead.
com.itextpdf.kernel.pdf.annot.PdfMarkupAnnotation.setExternalData(PdfName) use `PdfMarkupAnnotation.setExternalData(PdfDictionary)` instead
com.itextpdf.layout.ElementPropertyContainer.setFont(String) This method will be removed in 7.2. Use `ElementPropertyContainer.setFontFamily(String...)` instead.
com.itextpdf.forms.fields.PdfFormField.setFontAndSize(PdfFont, int) use `PdfFormField.setFontAndSize(PdfFont, float)` instead.
com.itextpdf.layout.renderer.TextRenderer.setGlyphLineAndFont(GlyphLine, PdfFont) use `TextRenderer.setProcessedGlyphLineAndFont(GlyphLine, PdfFont)` instead
com.itextpdf.kernel.pdf.PdfResources.setModified(boolean) Please use `PdfResources.setModified()`.
com.itextpdf.kernel.colors.PatternColor.setPattern(PdfPattern) To be removed in iText 7.2. In order to change pattern one shall create a new `PatternColor`.
com.itextpdf.kernel.pdf.filters.FlateDecodeFilter.setStrictDecoding(boolean) will be removed in 7.2, use `FlateDecodeStrictFilter` instead.
com.itextpdf.layout.renderer.TextRenderer.setText(GlyphLine, int, int) use `TextRenderer.setText(GlyphLine, PdfFont)` instead
com.itextpdf.signatures.PdfPKCS7.verify() This method will be removed in future versions. Please use `PdfPKCS7.verifySignatureIntegrityAndAuthenticity()` instead.
com.itextpdf.signatures.SignatureUtil.verifySignature(String) This method is deprecated and will be removed in future versions. Please use `SignatureUtil.readSignatureData(String)` instead.
com.itextpdf.signatures.SignatureUtil.verifySignature(String, String) This method is deprecated and will be removed in future versions. Please use `SignatureUtil.readSignatureData(String, String)` instead.

Deprecated Constructors
Constructor and Description
com.itextpdf.io.image.BmpImageData(byte[], boolean, int) will be removed in 7.2
com.itextpdf.io.image.BmpImageData(URL, boolean, int) will be removed in 7.2
com.itextpdf.layout.Canvas(PdfCanvas, PdfDocument, Rectangle) use `Canvas.Canvas(PdfCanvas, Rectangle)` instead.
com.itextpdf.layout.Canvas(PdfCanvas, PdfDocument, Rectangle, boolean) use `Canvas.Canvas(PdfCanvas, Rectangle, boolean)` instead.
com.itextpdf.styledxmlparser.css.CssFontFaceRule(String) Will be removed in 7.2. Use `CssFontFaceRule.CssFontFaceRule()` instead
com.itextpdf.styledxmlparser.css.page.CssMarginRule(String, String) Will be removed in 7.2. Use `CssMarginRule.CssMarginRule(String)` instead
com.itextpdf.svg.renderers.factories.DefaultSvgNodeRendererFactory(ISvgNodeRendererMapper) Will be removed in 7.2. The user should use the custom `ISvgNodeRendererFactory` implementation (or the custom
com.itextpdf.kernel.pdf.filters.FlateDecodeFilter(boolean) will be removed in 7.2, use `FlateDecodeStrictFilter` instead.
com.itextpdf.signatures.PdfSigner(PdfReader, OutputStream, boolean) will be removed in next major release. Use `PdfSigner.PdfSigner(PdfReader, OutputStream, StampingProperties)` instead.
com.itextpdf.signatures.PdfSigner(PdfReader, OutputStream, String, boolean) will be removed in next major release. Use `PdfSigner.PdfSigner(PdfReader, OutputStream, String, StampingProperties)` instead.
com.itextpdf.svg.processors.impl.SvgProcessorResult(Map, ISvgNodeRenderer, FontProvider, FontSet) use `SvgProcessorResult.SvgProcessorResult(Map, ISvgNodeRenderer, SvgProcessorContext)` instead. Will be removed in 7.2.
com.itextpdf.kernel.Version() Use `Version.getInstance()` instead. Will be removed in next major release.

Deprecated API

Contents