Skip to content

Latest commit

 

History

History
587 lines (427 loc) · 17.5 KB

ReleaseNotes.md

File metadata and controls

587 lines (427 loc) · 17.5 KB
Raw

Release Notes

Release 0.3.6 (NOT RELEASED YET)

General Changes

Upgraded Maven Plugins

  • maven-release-plugin to 2.5.3
  • maven-site-plugin to 3.5.1
  • maven-shade-plugin to 2.4.3
  • maven-jar-plugin to 3.0.2
  • maven-source-plugin 3.0.1
  • maven-surefire/failsafe-plugin to 2.19.1
  • maven-resources-plugin to 3.0.1
  • Add missing maven-javadoc-plugin 2.10.4

Upgraded Maven Plugins JENKINS-35108

  • maven-clean-plugin to 3.0.0
  • maven-resources-plugin to 3.0.0
  • maven-jar-plugin to 3.0.0

Fixed issue 176 HttpResponseException: Not Found (createJob) Based on the wrong usage of the sub methods using crumbFlag=true instead of crumbFlag=false.

Fixed issue 162

JenkinsJob.details() produced NPE which has been got via view.getJob().

Fixed issue 172

The implementation BuildWithDetails.getCauses() could cause an NPE which now has been imroved to prevent it. Thanks for hint which brought me to reconsider the implementation.

Serveral issues fixed related to using logging framework issue-161, issue-113 and JENKINS-35002

Added slf4j-api as foundation for logging. Using log4j2-slf4j-impl in jenkins-client-it-docker for logging. As a user you can now decide which logging framework you would like to use.

Changed the structure and integrated Docker IT

API Changes

The attributes of the following classes have been made private. They are only accessible via getters/setters.

MavenArtifact, ComputerWithDetails, Executable, FolderJob, JobWithDetails, MavenJobWithDetails, MavenModule, MavenModuleRecord, PluginManager

Fixed issue 174

jenkins.getComputerSet().getComputer() produced an error. Changed getComputer() into getComputers() cause it returns a list an not only a single computer. Based on the above problem the Executor needed to be changed to represent the correct data which is being returned.

public class ComputerSet {
   public List<ComputerWithDetails> getComputers();
}
public class Executor {
  public Job getCurrentExecutable();
  public Job getCurrentWorkUnit();
}

Fixed issue 169 Add crumbFlag to renameJob

Added supplemental renameJob method which supports crumbFlag. Furthermore added renameJob which supports folder with and without crumbFlag. So we now have the following methods to rename jobs:

public class JenkinsServer {
  public void renameJob(String oldJobName, String newJobName) throws IOException;
  public void renameJob(String oldJobName, String newJobName, Boolean crumbFlag) throws IOException;
  public void renameJob(FolderJob folder, String oldJobName, String newJobName) throws IOException;
  public void renameJob(FolderJob folder, String oldJobName, String newJobName, Boolean crumbFlag) throws IOException;
}

Fixed issue 168 deletejobs in folder

Added new method to delete a job within a folder.

public class JenkinsServer {
 public void deleteJob(FolderJob folder, String jobName) throws IOException;
}

Changing getLocalContext(), setLocalContext()

The protected method getLocalContext() now returns HttpContext instead of BasicHttpContext. So the API has changed from the following:

public class JenkinsServer {
  protected BasicHttpContext getLocalContext();
  protected void setLocalContext(BasicHttpContext localContext); 
  .
}

into this:

public class JenkinsServer {
  protected HttpContext getLocalContext();
  protected void setLocalContext(HttpContext localContext); 
  .
}

Apart from that the visibility of the class PreemptiveAuth has been changed from package private to public.

Get Jenkins Version from http header

public class JenkinsServer {
  public String getVersion();
  .
}

Added description for Job

public class JobWithDetails {
  public String getDescription();
  .
}

Release 0.3.5

API Changes

Fixed issue 159

The following methods have been changed to return Collections.emtpyList() if no builds exists or have ran before.

getAllBuilds(Range range);
getAllBuilds(), 
getBuilds()

Fixed NPE

The JobWithDetails class contains several methods which could have returned null. This has been changed to return non null values.

     public List<Job> getDownstreamProjects();
     public List<Job> getUpstreamProjects();

They will return Collections.emptyList().

The following methods will return Build.BUILD_HAS_NEVER_RAN in cases where no build has executed for the appropriate methods instead of the previous null value.

    public Build getFirstBuild();
    public Build getLastBuild();
    public Build getLastCompletedBuild();
    public Build getLastFailedBuild();
    public Build getLastStableBuild();
    public Build getLastSuccessfulBuild();
    public Build getLastUnstableBuild();
    public Build getLastUnsuccessfulBuild();

Added getAllBuilds(), getAllBuilds(Range range)

The JobWithDetails has been enhanced with two methods to get all builds which exists or a range can be used to select.

Note: There seemed to be no option to extract simply the number of existing builds of a particular job via the REST API.

public class JobWithDetails {
    public List<Build> getAllBuilds() throws IOException;
    public List<Build> getAllBuilds(Range range) throws IOException;
}

Added renameJob(..)

public class JenkinsServer {
  renameJob(String jobName, String newJobName) throws IOException;
  .
}

Release 0.3.4

API Changes

Added toggleOffline Node Added toggleOffline to ComputerWithDetails class.

public class ComputerWithDetails {
  public void toggleOffline(boolean crumbFlag) throws IOException;
  public void toggleOffline() throws IOException;
}

Added getPluginManager() to JenkinsServer

PluginManager getPluginManager() throws IOException;

Added method to get Plugin.

public class PluginManager extends BaseModel {
    public List<Plugin> getPlugins()
}

Plugin class contains methods to get informations about the plugins plus a PluginDependency class.

Added getFileFromWorkspace() to Job Added method getFileFromWorkspace() to Job class to get a file from workspace in Jenkins.

String getFileFromWorkspace(String fileName)

Make jobNames case sensitive.

TestCase class enhanced Now the TestCase contains the information about the errorDetails and the errorStackTrace of a failed test case.

String getErrorDetails();
String getErrorStackTrace()

Added disableJob, enabledJob The following methods have been added to support enabling and disabling jobs.

void disableJob(String jobName);
void disableJob(String jobName, boolean crumbFlag);
void enableJob(String jobName);
void enableJob(String jobName, boolean crumbFlag);

Fixed #128 Added OfflineCause as a real object in ComputerWithDetails Added OfflineCause class which can now being used as a return type for the attribute offlineCause instead of Object in ComputerWithDetails.

public class ComputerWithDetails {
  Object offlineCause;
..
}

into the following which also influenced the appropriate return types of the getters:

into

public class ComputerWithDetails {
    OfflineCause offlineCause;

    public OfflineCause getOfflineCause() throws IOException;

}

Fixed #135 Created documentation area Started a documentation area under src/site/ for either Markdown or asciidoctor.

Fixed #130 org.jvnet.hudson:xstream I needed to remove the toString method from View class which uses the XStream classes which does not make sense from my point of view.

Fixed #144 Problems with spaces in paths and job names

Fixed #133 How do we find out which system the built was build on?

Now BuildWithDetails API has been enhanced with the following method get the information on which node this build has ran.

String getBuiltOn();

Fixed #146 duration / estimatedDuration are long

The API in BuildWithDetailshas been changed to represent the change in datatype.

int getDuration();
int getEstimatedDuration();

into:

long getDuration();
long getEstimatedDuration();

Release 0.3.3

Fixed #111 A missing dependency to jaxen caused problems The problem was that the dependency has missed from the compile scope which caused problems for users to use. The dependency was there via transitive dependency of a test scoped artifact.

Do not propagate IOException when GET for /CrumbIssuer fails

API Changes

Added Cloudbees Folder support The following methods have been added to support FolderJob type.

void createFolder(String jobName, Boolean crumbFlag);
Optional<FolderJob> getFolderJob(Job job);
Map<String, Job> getJobs(FolderJob folder);
Map<String, Job> getJobs(FolderJob folder, String view);
Map<String, View> getViews(FolderJob folder);
View getView(FolderJob folder, String name);
JobWithDetails getJob(FolderJob folder, String jobName);
MavenJobWithDetails getMavenJob(FolderJob folder, String jobName);
void createJob(FolderJob folder, String jobName, String jobXml);
void createJob(FolderJob folder, String jobName, String jobXml, Boolean crumbFlag);

Release 0.3.2

API Changes:

JobWithDetails has been enhanced with information about the first build.

Build getFirstBuild()

The JenkinsServer API has been enhanced to get information about the Queue

QueueItem getQueueItem(QueueReference ref) throws IOException 
Build getBuild(QueueItem q)  throws IOException

The JenkinsHttpClient API has been changed from the following:

JenkinsHttpClient(URI uri, DefaultHttpClient defaultHttpClient);

into

JenkinsHttpClient(URI uri, CloseableHttpClient client);

Furthermore the JenkinsHttpClient API has been enhanced with the following method which allows to create an unauthenticated Jenkins HTTP client.

JenkinsHttpClient(URI uri, HttpClientBuilder builder);

The Build class Stop method needed to be changed internally based on an inconsistencies in Jenkins versions. (This might be change in future). There are versions 1.565 which supports the stop method as a post call, version 1.609.1 support it as a get call and 1.609.2 as a post call.

The Job class has been enhanced to trigger parameterized builds.

QueueReference build(Map<String, String> params, boolean crumbFlag) throws IOException;

Release 0.3.1

API Changes:

Until to Release 0.3.0 the getLoadStatistics() method returned a simple Map which needed to be changed to represent the information which is returned.

So the old one looked like this:

Map getLoadStatistics();

The new one looks like this:

LoadStatistics getLoadStatistics() throws IOException

You can see how it works by using the JenkinsLoadStatisticsExample.java.

The API for getExecutors() has been changed from a simple Map into something more meaningful.

The old one looked like this:

List<Map> getExecutors();

where as the new API looks like this:

List<Executor> getExecutors();

This will result in a list of Executor which contain supplemental informations about the appropriate executor.

Issues

Issue #53

This release contains new functionality like support to get the list of existing views. This can be accomplished by using the following:

Map<String, View> views = jenkins.getViews();

Issue #67

The change for getExecutors() which is documented in API changes.

Issue #82

The information about the ChangeSet and the culprit has been improved.

JenkinsServer jenkins = new JenkinsServer(new URI("http://localhost:8080/jenkins"), "admin", "password");
MavenJobWithDetails mavenJob = js.getMavenJob("javaee");
BuildWithDetails details = mavenJob.getLastSuccessfulBuild().details();

So now you can extract the causes which is related to the trigger which triggered the build.

List<BuildCause> causes = details.getCauses();

With the help of getChangeSet() you can extract the changeset information of your build:

BuildChangeSet changeSet = details.getChangeSet();

By using the changeSet.getKind() you would expect to get the kind of version control which has been used. If you use Git or Subversion this is true but unfortunately it is not true for all version control systems (for example TFS).

The information about files which have been changed an other information can be extracted by using the following:

List<BuildChangeSetItem> items = changeSet.getItems();

If you like to get a better overview check the example file in the project.

Issue #89

Extract TestReport from Jenkins

JenkinsServer js = new JenkinsServer(URI.create("http://jenkins-server/"));
MavenJobWithDetails mavenJob = js.getMavenJob("MavenJob");
BuildWithDetails details = mavenJob.getLastSuccessfulBuild().details();
TestReport testReport = mavenJob.getLastSuccessfulBuild().getTestReport();

You can extract the information about the tests which have run which contains information about the number of tests, failed tests and skipped tests etc. For a more detailed example take a look into the project.