Colette Turbeville

Jenkins Quickstart Guide for Java Developers

2018-05-17T00:00:00+00:00

Jenkins Quickstart Guide for Java Developers

Jenkins is an open source continuous integration server written in Java. This guide is intended to get you quickly up and running with Jenkins, while using some of its continuous integration (CI) capabilities.

Before you begin, you need the following system requirements:

Storage

512MB available
20 GB of drive space

Applications

Install Jenkins

Download Jenkins, choose the installation package that works with your environment.
Double click the installer to launch the Jenkins install wizard, this will take you through the installation process.
When the installation is complete, a local instance of Jenkins is launched. Your browser window will open to this locally running instance, where you are prompted to log in to complete the installation.
Before you log in, you need to get the password set by Jenkins during the install. To get your password, open a terminal and type:
```
sudo cat /Users/Shared/Jenkins/Home/secrets/initialAdminPassword
```
Copy the password
Return to the Jenkins browser window, enter your password and log in.

You now have Jenkins installed and running

Creating a CI Pipeline

In the Jenkins control panel, create a new file and name it Jenkinsfile.

Insert the following code into the Jenkinsfile:

Jenkinsfile (Declarative Pipeline)
pipeline {
 agent { docker { image 'maven:3.3.3' } }
 stages {
     stage('build') {
         steps {
             sh 'mvn --version'
         }
     }
 }
}

This will be your new CI pipleline, give your pipleline a name.
Select Multibranch Pipeline
Next, select Add source and choose the repository with the new Jenkinsfile you just created.
Click Save

You have created a new a CI pipeline in Jenkins.

Now that you are familiar with some of the basic CI functionality using in Jenkins, you can start creating more complex pipelines by building Java applications with Maven.

Quickstart Guide

2016-01-10T00:00:00+00:00

This project was for a Java spreadsheet tools company.

ExtenXLS Quickstart Guide

ExtenXLS is a Java spreadsheet library designed for developers familiar with the Java syntax, spreadsheet programs, and the concept of file templates. This guide is intended to get you started quickly programming with ExtenXLS.

Basic use of the API requires the following steps:

Copy ExtenXLS.jar and extenxls.lic to a project directory. Make sure that the jar is in the classpath of your project. The ExtenXLS.jar file needs to be on your classpath in order for the JVM to find the ExtenXLS class files.
In your Java code, import the com.extentech.ExtenXLS package.
Create a new WorkBookHandle, this can be a new, empty workbook with three sheets, or you can parse an existing XLS file in the form of a byte array or from another data source.

Note: Review the WorkBookHandle constructors in the API documentation

      to see which WorkBookHandle is appropriate for your application.

Start working with a worksheet by using the WorkBookHandle.getWorkSheet(String sheetname) method.
Make sure to catch the WorkSheetNotFoundException in case the expected sheet does not already exist in the file.
Access the cell values using the WorkSheetHandle.getCell(Sheetname:CellAddress) method
Add new cells to the spreadsheet with the CellHandle WorkSheetHandle.add(Object ob, String address) method.
Set and get the value of cells by using the CellHandle.setCellVal(Object ob) and object CellHandle.getCellVal() methods.
Finally, stream the WorkBook bytes to an output file using the WorkBookHandle.getBytes() method. If you are writing to a web application, you can send the bytes over a ServletResponse to a browser, write out to a file, or to any byte array consumer.

ExtenXLS Working With Charts

2016-01-09T00:00:00+00:00

Working With Charts

With ChartHandle, you can add cells to a chart, change a chart’s title, axis labels, and copy charts between other worksheets and workbooks.

Begin by retrieving a ChartHandle from an existing chart in a worksheet. To retrieve a ChartHandle, use the ChartHandle WorkSheetHandle.getChart(String chartname) method.

try{        ChartHandle performancechart = mysheet.getChart('Performance');
}catch(ChartNotFoundException e){        
  // oops!
};

With a ChartHandle, you can add cells to the chart using the ChartHandle.changeSeriesRange(String originalrange, String newrange) method.

if(performancechart.changeSeriesRange('Sheet1!C23:E23', 'Sheet1!C23:G23')){
System.out.println('Successfully Added Columns F and G to Series Range');
}

To change the chart title, use the Charthandle.setTitle(String title) method.

performancechart.setChartTitle('Athletic Performance Results');

To change the axis labels, or other text labels in the chart use the ChartHandle.changeTextValue(String originaltext, String newtext) method.

if(ct.changeTextValue('50 Meter Dash Times", "High Jump    Distance')){
System.out.println('Successfully Changed Categories Label');
}

To copy a chart into another sheet or workbook, use:

book.copyChartToSheet("New Chart Title", "Sheet3");

Java Spreadsheet User Guide & Manual

2015-08-16T00:00:00+00:00

Worksheet Functions

The WorkSheetHandle provides a handle to a worksheet within an XLS file, and includes convenience methods for working with the cell values within a sheet. The WorkSheetHandle allows access to a particular worksheet within your WorkBookHandle.

Instantiating the WorksheetHandle

To gain access to the handle, use the getWorkSheet(String sheetName) method within the WorkBookHandle object:

WorkBook mybook = new WorkBook();
WorkSheetHandle sheet = mybook.getWorkSheet(Sheet1);

You can get an array of handles to all of the worksheets in a workbook by using the getWorkSheets() method:

WorkSheetHandle[] sheets = book.getWorkSheets();

This will return an array of handles to all of the worksheets in a workbook, giving flexibility to work with each one individually.

Creating, Copying, and Deleting Worksheets

To create a new worksheet, use the createWorkSheet(String newSheet) method. This will insert a new worksheet and place it at the end of the workbook.

createWorkSheet('mysheet');
WorkSheetHandle mysheet = new WorkSheet();

To delete any number of worksheets, use the remove method. To delete all worksheets in a workbook, use the removeAllWorkSheets() method.

sheet.remove('mysheet');
sheet.removeAllWorkSheets('mybook');

To copy an existing worksheet to your workbook, use the copyWorkSheet(String SourceSheetName NewSheetName) method. This will duplicate a worksheet in the workbook and add it to the end of the workbook with a new name.

WorkBook thisbook = new WorkBook(); WorkSheetHandle sheet = thisbook.getWorkSheet(sheet1);
createWorkSheet('newsheet');
copyWorkSheet('WorkSheet1', 'WorkSheet4');

Editing Sheet Names

The setSheetName(String newName) method can be used to modify or rename your worksheet. This method will change the name on the worksheet’s tab as well as all programmatic and internal references to that name.

setSheetName('sheet1', 'Records');

Getting, Setting and Reordering Tabs

Sheet tab names can be set and retrieved. To get the name of a worksheet, use the getSheetName() method.

String sheetname = mysheet.getSheetName();

To set the tab name, use the WorkSheetHandle.setSheetName(String NewName) method.

mysheet.setSheetName('CreditTracking');

Sheets can be selected so they appear as the first visible sheet when the output file is opened. You can also reorder sheets to your specifications. To select a worksheet and set it to the first visible tab in the workbook use the setFirstVisibleTab(int x) method.

WorkSheetHandle WorkSheet4 = new WorkSheet();
setTabIndex('0', 'WorkSheet4');

To reorder the display of the worksheet tabs, use the setTabIndex(int idx) method. This is a zero-based index. Thus, the first tab you will see displayed in your WorkBook will be 0.

setTabIndex('1','WorkSheet1');

Protect and Unprotect Worksheets

Worksheet protection can be set or removed to control any modifications in the output file. To lock the values of a worksheet, you can set the worksheet to “protect,” by using the setProtected(boolean b) method

mysheet.setProtected(true);

To unlock protected worksheets, use the setProtected(boolean b) method.

mysheet.setProtected(false)