GradleConnector (Gradle API 2.2-20140924021627+0000)

org.gradle.tooling.GradleConnector

A GradleConnector is the main entry point to the Gradle tooling API. You use this API as follows:
1. Call newConnector() to create a new connector instance.
2. Configure the connector. You must call forProjectDirectory(java.io.File) to specify which project you wish to connect to. Other methods are optional.
3. Call connect() to create the connection to a project.
4. When finished with the connection, call ProjectConnection.close to clean up.
Example:
```
 ProjectConnection connection = GradleConnector.newConnector()
    .forProjectDirectory(new File("someProjectFolder"))
    .connect();

 try {
    connection.newBuild().forTasks("tasks").run();
 } finally {
    connection.close();
 }
 
```
GradleConnector instances are not thread-safe. If you want to use a GradleConnector concurrently you must always create a new instance for each thread using newConnector(). Note, however, the ProjectConnection instances that a connector creates are completely thread-safe.

Since:
1.0-milestone-3

Methods Summary

Methods
Type	Name and description
`ProjectConnection`	`connect()` Creates a connection to the project in the specified project directory.
`GradleConnector`	`forProjectDirectory(File projectDir)` Specifies the working directory to use.
`static CancellationTokenSource`	`newCancellationTokenSource()` Creates a new CancellationTokenSource that can be used to cancel one or more LongRunningOperation executions.
`static GradleConnector`	`newConnector()` Creates a new connector instance.
`GradleConnector`	`useDistribution(URI gradleDistribution)` Specifies which Gradle distribution to use.
`GradleConnector`	`useGradleUserHomeDir(File gradleUserHomeDir)` Specifies the user's Gradle home directory to use.
`GradleConnector`	`useGradleVersion(String gradleVersion)` Specifies which Gradle version to use.
`GradleConnector`	`useInstallation(File gradleHome)` Specifies which Gradle installation to use.

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class Object`	`wait, wait, wait, equals, toString, hashCode, getClass, notify, notifyAll`

- Method Detail
  - public ProjectConnection connect()
    
    Creates a connection to the project in the specified project directory. You should call ProjectConnection.close when you are finished with the connection.
    throws:
    UnsupportedVersionException When the target Gradle version does not support this version of the tooling API.
    throws:
    GradleConnectionException On failure to establish a connection with the target Gradle version.
    
    Returns:
    The connection. Never return null.
    Since:
    1.0-milestone-3
  - public GradleConnector forProjectDirectory(File projectDir)
    
    Specifies the working directory to use.
    Returns:
    this
    Parameters:
    projectDir - The working directory.
    Since:
    1.0-milestone-3
  - public static CancellationTokenSource newCancellationTokenSource()
    
    Creates a new CancellationTokenSource that can be used to cancel one or more LongRunningOperation executions.
    Returns:
    The instance. Never returns null.
    Since:
    2.1
  - public static GradleConnector newConnector()
    
    Creates a new connector instance.
    Returns:
    The instance. Never returns null.
    Since:
    1.0-milestone-3
  - public GradleConnector useDistribution(URI gradleDistribution)
    
    Specifies which Gradle distribution to use. The appropriate distribution is downloaded and installed into the user's Gradle home directory. This replaces any value specified using useInstallation(java.io.File) or useGradleVersion(String). Defaults to a project-specific Gradle version.
    Returns:
    this
    Parameters:
    gradleDistribution - The distribution to use.
    Since:
    1.0-milestone-3
  - public GradleConnector useGradleUserHomeDir(File gradleUserHomeDir)
    
    Specifies the user's Gradle home directory to use. Defaults to ~/.gradle.
    Returns:
    this
    Parameters:
    gradleUserHomeDir - The user's Gradle home directory to use.
    Since:
    1.0-milestone-3
  - public GradleConnector useGradleVersion(String gradleVersion)
    
    Specifies which Gradle version to use. The appropriate distribution is downloaded and installed into the user's Gradle home directory. This replaces any value specified using useInstallation(java.io.File) or useDistribution(java.net.URI). Defaults to a project-specific Gradle version.
    Returns:
    this
    Parameters:
    gradleVersion - The version to use.
    Since:
    1.0-milestone-3
  - public GradleConnector useInstallation(File gradleHome)
    
    Specifies which Gradle installation to use. This replaces any value specified using useDistribution(java.net.URI) or useGradleVersion(String). Defaults to a project-specific Gradle version.
    Returns:
    this
    Parameters:
    gradleHome - The Gradle installation directory.
    Since:
    1.0-milestone-3

Summary:
Method

| Detail:
Method

Gradle API 2.2-20140924021627+0000

[Java] Class GradleConnector

Methods Summary

Inherited Methods Summary

Method Detail

public ProjectConnection connect()

public GradleConnector forProjectDirectory(File projectDir)

public static CancellationTokenSource newCancellationTokenSource()

public static GradleConnector newConnector()

public GradleConnector useDistribution(URI gradleDistribution)

public GradleConnector useGradleUserHomeDir(File gradleUserHomeDir)

public GradleConnector useGradleVersion(String gradleVersion)

public GradleConnector useInstallation(File gradleHome)