null
tikhomirov@578: * @return repository object, never null
tikhomirov@578: * @throws HgRepositoryNotFoundException if no repository found, or repository version is not supported
tikhomirov@578: */
tikhomirov@423: public HgRepository detect(File location) throws HgRepositoryNotFoundException {
tikhomirov@492: File dir = location.getAbsoluteFile();
tikhomirov@492: File repository;
tikhomirov@492: do {
tikhomirov@492: repository = new File(dir, ".hg");
tikhomirov@492: if (repository.exists() && repository.isDirectory()) {
tikhomirov@492: break;
tikhomirov@2: }
tikhomirov@492: repository = null;
tikhomirov@492: dir = dir.getParentFile();
tikhomirov@492:
tikhomirov@492: } while(dir != null);
tikhomirov@492: if (repository == null) {
tikhomirov@492: throw new HgRepositoryNotFoundException(String.format("Can't locate .hg/ directory of Mercurial repository in %s nor in parent dirs", location)).setLocation(location.getPath());
tikhomirov@148: }
tikhomirov@628: try {
tikhomirov@628: String repoPath = repository.getParentFile().getAbsolutePath();
tikhomirov@628: HgRepository rv = new HgRepository(getSessionContext(), repoPath, repository);
tikhomirov@628: int requiresFlags = rv.getImplHelper().getRequiresFlags();
tikhomirov@628: if ((requiresFlags & RequiresFile.REVLOGV1) == 0) {
tikhomirov@628: throw new HgRepositoryNotFoundException(String.format("%s: repository version is not supported (Mercurial <0.9?)", repoPath)).setLocation(location.getPath());
tikhomirov@628: }
tikhomirov@628: return rv;
tikhomirov@628: } catch (HgRuntimeException ex) {
tikhomirov@628: HgRepositoryNotFoundException e = new HgRepositoryNotFoundException("Failed to initialize Hg4J library").setLocation(location.getPath());
tikhomirov@628: e.initCause(ex);
tikhomirov@628: throw e;
tikhomirov@578: }
tikhomirov@4: }
tikhomirov@169:
tikhomirov@425: public HgBundle loadBundle(File location) throws HgRepositoryNotFoundException {
tikhomirov@169: if (location == null || !location.canRead()) {
tikhomirov@425: throw new HgRepositoryNotFoundException(String.format("Can't read file %s", location)).setLocation(String.valueOf(location));
tikhomirov@169: }
tikhomirov@618: return new HgBundle(getSessionContext(), new DataAccessProvider(getSessionContext()), location).link();
tikhomirov@169: }
tikhomirov@181:
tikhomirov@181: /**
tikhomirov@503: * Try to instantiate remote server using an immediate url or an url from configuration files
tikhomirov@503: *
tikhomirov@503: * @param key either URL or a key from configuration file that points to remote server; if null or empty string, default remote location of the supplied repository (if any) is looked up
tikhomirov@503: * @param hgRepo optional local repository to get default or otherwise configured remote location
tikhomirov@181: * @return an instance featuring access to remote repository, check {@link HgRemoteRepository#isInvalid()} before actually using it
tikhomirov@181: * @throws HgBadArgumentException if anything is wrong with the remote server's URL
tikhomirov@181: */
tikhomirov@181: public HgRemoteRepository detectRemote(String key, HgRepository hgRepo) throws HgBadArgumentException {
tikhomirov@698: URI uri;
tikhomirov@181: Exception toReport;
tikhomirov@181: try {
tikhomirov@698: uri = new URI(key);
tikhomirov@181: toReport = null;
tikhomirov@698: } catch (URISyntaxException ex) {
tikhomirov@698: uri = null;
tikhomirov@181: toReport = ex;
tikhomirov@181: }
tikhomirov@698: if (uri == null) {
tikhomirov@503: String server = null;
tikhomirov@503: if (hgRepo != null && !hgRepo.isInvalid()) {
tikhomirov@503: PathsSection ps = hgRepo.getConfiguration().getPaths();
tikhomirov@622: server = key == null || key.trim().length() == 0 ? ps.getDefault() : ps.getString(key, null); // XXX Java 1.5 isEmpty()
tikhomirov@503: } else if (key == null || key.trim().length() == 0) {
tikhomirov@503: throw new HgBadArgumentException("Can't look up empty key in a global configuration", null);
tikhomirov@503: }
tikhomirov@503: if (server == null) {
tikhomirov@503: server = getGlobalConfig().getSection("paths").get(key);
tikhomirov@503: }
tikhomirov@181: if (server == null) {
tikhomirov@181: throw new HgBadArgumentException(String.format("Can't find server %s specification in the config", key), toReport);
tikhomirov@181: }
tikhomirov@181: try {
tikhomirov@698: uri = new URI(server);
tikhomirov@698: } catch (URISyntaxException ex) {
tikhomirov@181: throw new HgBadArgumentException(String.format("Found %s server spec in the config, but failed to initialize with it", key), ex);
tikhomirov@181: }
tikhomirov@181: }
tikhomirov@698: return detectRemote(uri);
tikhomirov@181: }
tikhomirov@181:
tikhomirov@698: /**
tikhomirov@698: * Detect remote repository
tikhomirov@698: * Use of this method is discouraged, please use {@link #detectRemote(URI)} instead}
tikhomirov@698: *
tikhomirov@698: * @param url location of remote repository
tikhomirov@698: * @return instance to interact with remote repository
tikhomirov@698: * @throws HgBadArgumentException if location format is not a valid {@link URI}
tikhomirov@698: * @throws IllegalArgumentException if url is null
tikhomirov@698: */
tikhomirov@295: public HgRemoteRepository detect(URL url) throws HgBadArgumentException {
tikhomirov@171: if (url == null) {
tikhomirov@171: throw new IllegalArgumentException();
tikhomirov@171: }
tikhomirov@698: try {
tikhomirov@698: return detectRemote(url.toURI());
tikhomirov@698: } catch (URISyntaxException ex) {
tikhomirov@698: throw new HgBadArgumentException(String.format("Bad remote repository location: %s", url), ex);
tikhomirov@170: }
tikhomirov@698: }
tikhomirov@698:
tikhomirov@698: /**
tikhomirov@698: * Resolves location of remote repository.
tikhomirov@698: *
tikhomirov@698: *
Choice between {@link URI URIs} and {@link URL URLs} done in favor of former because they are purely syntactical,
tikhomirov@698: * while latter have semantics of {@link URL#openConnection() connection} establishing, which is not always possible.
tikhomirov@698: * E.g. one can't instantiate new URL("ssh://localhost/") as long as there's no local {@link URLStreamHandler}
tikhomirov@698: * for the protocol, which is the case for certain JREs out there. The way {@link URLStreamHandlerFactory URLStreamHandlerFactories}
tikhomirov@698: * are installed (static field/method) is quite fragile, and definitely not the one to rely on from a library's code (apps can carefully
tikhomirov@698: * do this, but library can't install own nor expect anyone outside there would do). Use of fake {@link URLStreamHandler} (fails to open
tikhomirov@698: * every connection) is possible, of course, although it seems to be less appropriate when there is alternative with {@link URI URIs}.
tikhomirov@698: *
tikhomirov@698: * @param uriRemote remote repository location
tikhomirov@698: * @return instance to interact with remote repository
tikhomirov@698: * @throws HgBadArgumentException
tikhomirov@698: */
tikhomirov@698: public HgRemoteRepository detectRemote(URI uriRemote) throws HgBadArgumentException {
tikhomirov@698: RemoteDescriptor rd = getSessionContext().getRemoteDescriptor(uriRemote);
tikhomirov@698: if (rd == null) {
tikhomirov@698: throw new HgBadArgumentException(String.format("Unsupported remote repository location:%s", uriRemote), null);
tikhomirov@698: }
tikhomirov@698: return new HgRemoteRepository(getSessionContext(), rd);
tikhomirov@170: }
tikhomirov@181:
tikhomirov@181: private ConfigFile getGlobalConfig() {
tikhomirov@181: if (globalCfg == null) {
tikhomirov@618: globalCfg = new ConfigFile(getSessionContext());
tikhomirov@295: try {
tikhomirov@295: globalCfg.addLocation(new File(System.getProperty("user.home"), ".hgrc"));
tikhomirov@628: } catch (HgIOException ex) {
tikhomirov@295: // XXX perhaps, makes sense to let caller/client know that we've failed to read global config?
tikhomirov@618: getSessionContext().getLog().dump(getClass(), Warn, ex, null);
tikhomirov@295: }
tikhomirov@181: }
tikhomirov@181: return globalCfg;
tikhomirov@181: }
tikhomirov@295:
tikhomirov@618: public SessionContext getSessionContext() {
tikhomirov@295: if (sessionContext == null) {
tikhomirov@431: sessionContext = new BasicSessionContext(null);
tikhomirov@295: }
tikhomirov@295: return sessionContext;
tikhomirov@295: }
tikhomirov@698:
tikhomirov@698:
tikhomirov@698: /**
tikhomirov@698: * Session context ({@link SessionContext#getRemoteDescriptor(URI)} gives descriptor of remote when asked.
tikhomirov@698: */
tikhomirov@698: @Experimental(reason="Work in progress")
tikhomirov@698: public interface RemoteDescriptor {
tikhomirov@698: URI getURI();
tikhomirov@698: Authenticator getAuth();
tikhomirov@698: }
tikhomirov@698:
tikhomirov@698: @Experimental(reason="Work in progress")
tikhomirov@698: public interface Authenticator {
tikhomirov@698: public void authenticate(RemoteDescriptor remote, AuthMethod authMethod);
tikhomirov@698: }
tikhomirov@698:
tikhomirov@698: /**
tikhomirov@698: * Clients do not implement this interface, instead, they invoke appropriate authentication method
tikhomirov@698: * once they got user input
tikhomirov@698: */
tikhomirov@698: @Experimental(reason="Work in progress")
tikhomirov@698: public interface AuthMethod {
tikhomirov@698: public void noCredentials() throws AuthFailedException;
tikhomirov@698: public boolean supportsPassword();
tikhomirov@698: public void withPassword(String username, byte[] password) throws AuthFailedException;
tikhomirov@698: public boolean supportsPublicKey();
tikhomirov@698: public void withPublicKey(String username, InputStream publicKey, String passphrase) throws AuthFailedException;
tikhomirov@698: public boolean supportsCertificate();
tikhomirov@698: public void withCertificate() throws AuthFailedException;
tikhomirov@698: }
tikhomirov@698:
tikhomirov@698: @SuppressWarnings("serial")
tikhomirov@698: public class AuthFailedException extends Exception /*XXX HgRemoteException?*/ {
tikhomirov@698: public AuthFailedException(String message, Throwable cause) {
tikhomirov@698: super(message, cause);
tikhomirov@698: }
tikhomirov@698: }
tikhomirov@2: }