Deprecated API

Contents

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

Deprecated Classes

Class and Description
org.eclipse.jgit.transport.ReceivePack.FirstLine Use FirstCommand instead.
org.eclipse.jgit.transport.UploadPack.FirstLine Use FirstWant instead

Deprecated Fields

Field and Description
org.eclipse.jgit.lib.Constants.CHARACTER_ENCODING Use StandardCharsets.UTF_8 directly instead.
org.eclipse.jgit.lib.Constants.CHARSET Use StandardCharsets.UTF_8 directly instead.
org.eclipse.jgit.transport.PacketLineIn.DELIM Callers should use PacketLineIn.isDelimiter(String) to check if a string is the delimiter.
org.eclipse.jgit.transport.PacketLineIn.END Callers should use PacketLineIn.isEnd(String) to check if a string is the end marker, or PacketLineIn.readStrings() to iterate over all strings in the input stream until the marker is reached.
org.eclipse.jgit.util.RawParseUtils.UTF8_CHARSET use StandardCharsets.UTF_8 instead

Deprecated Methods

Method and Description
org.eclipse.jgit.revwalk.ReachabilityChecker.areAllReachable(Collection<RevCommit>, Collection<RevCommit>) see {ReachabilityChecker.areAllReachable(Collection, Stream)
org.eclipse.jgit.dircache.DirCacheCheckout.checkoutEntry(Repository, DirCacheEntry, ObjectReader) since 5.1, use DirCacheCheckout.checkoutEntry(Repository, DirCacheEntry, ObjectReader, boolean, CheckoutMetadata) instead
org.eclipse.jgit.util.FS_POSIX.createNewFile(File)
org.eclipse.jgit.util.FS.createNewFile(File) use FS.createNewFileAtomic(File) instead
org.eclipse.jgit.revwalk.ObjectWalk.createObjectReachabilityChecker() use ObjectReader#createObjectReachabilityChecker(ObjectWalk) instead.
org.eclipse.jgit.revwalk.RevWalk.createReachabilityChecker() use ObjectReader#createReachabilityChecker(RevWalk) instead.
org.eclipse.jgit.lib.AnyObjectId.equals(AnyObjectId, AnyObjectId) use AnyObjectId.isEqual(AnyObjectId, AnyObjectId) instead
org.eclipse.jgit.merge.MergeFormatter.formatMerge(OutputStream, MergeResult<RawText>, List<String>, String) Use MergeFormatter.formatMerge(OutputStream, MergeResult, List, Charset) instead.
org.eclipse.jgit.merge.MergeFormatter.formatMerge(OutputStream, MergeResult, String, String, String, String) use MergeFormatter.formatMerge(OutputStream, MergeResult, String, String, String, Charset) instead.
org.eclipse.jgit.lib.Repository.getAllRefs() use getRefDatabase().getRefs() instead.
org.eclipse.jgit.internal.storage.file.LockFile.getCommitLastModified() use LockFile.getCommitLastModifiedInstant() instead
org.eclipse.jgit.treewalk.WorkingTreeIterator.getEntryLastModified() use WorkingTreeIterator.getEntryLastModifiedInstant() instead
org.eclipse.jgit.transport.UploadPack.getFilterBlobLimit() Use UploadPack.getFilterSpec() instead
org.eclipse.jgit.transport.Transport.getFilterBlobLimit() Use Transport.getFilterSpec() instead
org.eclipse.jgit.dircache.DirCacheEntry.getLastModified() use DirCacheEntry.getLastModifiedInstant() instead
org.eclipse.jgit.treewalk.WorkingTreeIterator.Entry.getLastModified() use WorkingTreeIterator.Entry.getLastModifiedInstant() instead
org.eclipse.jgit.treewalk.FileTreeIterator.FileEntry.getLastModified()
org.eclipse.jgit.util.FS.Attributes.getLastModifiedTime() use getLastModifiedInstant instead
org.eclipse.jgit.storage.file.WindowCacheStats.getOpenBytes() use WindowCacheStats.getOpenByteCount() instead
org.eclipse.jgit.storage.file.WindowCacheStats.getOpenFiles() use WindowCacheStats.getOpenFileCount() instead
org.eclipse.jgit.treewalk.CanonicalTreeParser.getParent() internal use only
org.eclipse.jgit.lib.RefDatabase.getRef(String) Use RefDatabase.findRef(String) instead.
org.eclipse.jgit.lib.RefDatabase.getRefs(String) use RefDatabase.getRefsByPrefix(java.lang.String) instead
org.eclipse.jgit.lib.Repository.getTags() use getRefDatabase().getRefsByPrefix(R_TAGS) instead
org.eclipse.jgit.lib.Repository.hasObject(AnyObjectId) use getObjectDatabase().has(objectId)
org.eclipse.jgit.lib.CoreConfig.isLogAllRefUpdates() since 5.6; default value depends on whether the repository is bare. Use Config.getEnum(String, String, String, Enum) directly.
org.eclipse.jgit.internal.storage.file.FileSnapshot.lastModified() use FileSnapshot.lastModifiedInstant() instead
org.eclipse.jgit.util.FS.lastModified(File) use FS.lastModifiedInstant(Path) instead
org.eclipse.jgit.dircache.DirCacheEntry.mightBeRacilyClean(int, int) use DirCacheEntry.mightBeRacilyClean(Instant) instead
org.eclipse.jgit.lib.Repository.peel(Ref) use getRefDatabase().peel(ref) instead.
org.eclipse.jgit.gitrepo.RepoCommand.RemoteReader.readFile(String, String, String) Use RepoCommand.RemoteReader.readFileWithMode(String, String, String) instead
org.eclipse.jgit.internal.storage.file.WindowCache.reconfigure(WindowCacheConfig) use cfg.install() to avoid internal reference.
org.eclipse.jgit.internal.storage.file.FileSnapshot.save(long) use FileSnapshot.save(Instant) instead.
org.eclipse.jgit.transport.RefAdvertiser.send(Map<String, Ref>) use RefAdvertiser.send(Collection) instead.
org.eclipse.jgit.api.StashApplyCommand.setApplyIndex(boolean) use StashApplyCommand.setRestoreIndex(boolean) instead
org.eclipse.jgit.api.StashApplyCommand.setApplyUntracked(boolean) use StashApplyCommand.setRestoreUntracked(boolean) instead
org.eclipse.jgit.util.FS.setAsyncFileStoreAttributes(boolean) Use FS.FileStoreAttributes.setBackground(boolean) instead
org.eclipse.jgit.transport.ReceivePack.setEchoCommandFailures(boolean) no widely used Git versions need this any more
org.eclipse.jgit.lib.CommitBuilder.setEncoding(String) use ObjectBuilder.setEncoding(Charset) instead.
org.eclipse.jgit.transport.Transport.setFilterBlobLimit(long) Use Transport.setFilterSpec(FilterSpec) instead
org.eclipse.jgit.api.CheckoutCommand.setForce(boolean) this method was badly named comparing its semantics to native git's checkout --force option, use CheckoutCommand.setForceRefUpdate(boolean) instead
org.eclipse.jgit.util.FS.setLastModified(File, long) use FS.setLastModified(Path, Instant) instead
org.eclipse.jgit.dircache.DirCacheEntry.setLastModified(long) use DirCacheEntry.setLastModified(Instant) instead
org.eclipse.jgit.api.RemoteSetUrlCommand.setName(String) use RemoteSetUrlCommand.setRemoteName(java.lang.String) instead
org.eclipse.jgit.api.RemoteRemoveCommand.setName(String) use RemoteRemoveCommand.setRemoteName(java.lang.String) instead
org.eclipse.jgit.api.RemoteSetUrlCommand.setPush(boolean) use RemoteSetUrlCommand.setUriType(org.eclipse.jgit.api.RemoteSetUrlCommand.UriType) instead
org.eclipse.jgit.api.RemoteSetUrlCommand.setUri(URIish) use RemoteSetUrlCommand.setRemoteUri(org.eclipse.jgit.transport.URIish) instead
org.eclipse.jgit.lib.TagBuilder.toByteArray() since 5.11; use TagBuilder.build() instead

Deprecated Constructors

Constructor and Description
org.eclipse.jgit.util.io.AutoLFInputStream(InputStream, boolean) since 5.9, use AutoLFInputStream.create(InputStream, StreamFlag...) instead
org.eclipse.jgit.util.io.AutoLFInputStream(InputStream, boolean, boolean) since 5.9, use AutoLFInputStream.create(InputStream, StreamFlag...) instead
org.eclipse.jgit.errors.PackInvalidException(File) Use PackInvalidException(File, Throwable).
org.eclipse.jgit.errors.PackInvalidException(String) Use PackInvalidException(String, Throwable).