Mercurial > hg4j
diff src/org/tmatesoft/hg/repo/HgDataFile.java @ 416:d30083c80d52
Better names - non-confusing and aligned with the rest of API
author | Artem Tikhomirov <tikhomirov.artem@gmail.com> |
---|---|
date | Thu, 22 Mar 2012 19:11:33 +0100 |
parents | ee8264d80747 |
children | ccd7d25e5aea |
line wrap: on
line diff
--- a/src/org/tmatesoft/hg/repo/HgDataFile.java Thu Mar 22 18:54:11 2012 +0100 +++ b/src/org/tmatesoft/hg/repo/HgDataFile.java Thu Mar 22 19:11:33 2012 +0100 @@ -88,7 +88,7 @@ } /** - * Handy shorthand for {@link #length(int) length(getRevisionIndex(nodeid))} + * Handy shorthand for {@link #getLength(int) length(getRevisionIndex(nodeid))} * * @param nodeid revision of the file * @@ -96,9 +96,9 @@ * @throws HgInvalidRevisionException if supplied nodeid doesn't identify any revision from this revlog (<em>runtime exception</em>) * @throws HgInvalidControlFileException if access to revlog index/data entry failed */ - public int length(Nodeid nodeid) throws HgInvalidControlFileException, HgInvalidRevisionException { + public int getLength(Nodeid nodeid) throws HgInvalidControlFileException, HgInvalidRevisionException { try { - return length(getRevisionIndex(nodeid)); + return getLength(getRevisionIndex(nodeid)); } catch (HgInvalidControlFileException ex) { throw ex.isRevisionSet() ? ex : ex.setRevision(nodeid); } catch (HgInvalidRevisionException ex) { @@ -107,12 +107,20 @@ } /** + * @deprecated Use {@link #getLength(Nodeid)} instead + */ + @Deprecated + public int length(Nodeid nodeid) throws HgInvalidControlFileException, HgInvalidRevisionException { + return getLength(nodeid); + } + + /** * @param fileRevisionIndex - revision local index, non-negative. From predefined constants, only {@link HgRepository#TIP} makes sense. * @return size of the file content at the revision identified by local revision number. * @throws HgInvalidRevisionException if supplied argument doesn't represent revision index in this revlog (<em>runtime exception</em>) * @throws HgInvalidControlFileException if access to revlog index/data entry failed */ - public int length(int fileRevisionIndex) throws HgInvalidControlFileException, HgInvalidRevisionException { + public int getLength(int fileRevisionIndex) throws HgInvalidControlFileException, HgInvalidRevisionException { if (wrongRevisionIndex(fileRevisionIndex) || fileRevisionIndex == BAD_REVISION) { throw new HgInvalidRevisionException(fileRevisionIndex); } @@ -138,6 +146,14 @@ } return dataLen; } + + /** + * @deprecated Use {@link #getLength(int)} instead + */ + @Deprecated + public int length(int fileRevisionIndex) throws HgInvalidControlFileException, HgInvalidRevisionException { + return getLength(fileRevisionIndex); + } /** * Reads content of the file from working directory. If file present in the working directory, its actual content without @@ -549,6 +565,8 @@ */ /** + * + * @param fileRevisionIndex - revision local index, non-negative, or {@link HgRepository#TIP}. * FIXME EXCEPTIONS * @throws HgInvalidControlFileException * @throws HgInvalidRevisionException @@ -557,7 +575,7 @@ int changesetRevIndex = getChangesetRevisionIndex(fileRevisionIndex); return getRepo().getManifest().extractFlags(changesetRevIndex, getPath()); } - + @Override public String toString() { StringBuilder sb = new StringBuilder(getClass().getSimpleName());