Frequently Used Java Commands

February 5, 2019

Native Java Documentation

Integer
String str = Integer.toString(iValue);
int iValue = (Integer.valueOf(str)).intValue();

Double
String str = Double.toString(dValue);
double dValue = (Double.valueOf(str)).doubleValue();

String
Index Numbers
abcdefgh
012345678

String substr = str.substring(iBegin,iEnd);

str.substring(2,5) = cde
int indexMatch = str.indexOf(strFind);
str.indexOf(”c”) = 2
int indexMatch = str.lastIndexOf(strFind);
int iLength = str.length();
boolean bMatch = str.equals(strCompare);

Arrays
int iLength = iArray.length;

ClassName[] classArray = new ClassName[nClasses];

classArray[0] = new ClassName();
classArray[1] = new ClassName();

int[] iArray = new int[nLocs];

int[] iArray = {0,1,2};

int[][] iMatrix = new int[nLocsFirst][];

iMatrix[0] = new int[nLocs0];
iMatrix[1] = new int[nLocs1];

For Each
int[] iArray;
for (int iElement : iArray) {
System.out.println(iElement);
}
 2

Vector
Vector<Class> vec = new Vector<Class>(); Class: String, Integer , etc
int iLocs = vec.size();
vec.removeAllElements();

vec.addElement(str);
String str = (String)vec.elementAt(iLocation);

vec.addElement(new Integer(iValue));
int iValue = ((Integer)(vec.elementAt(iLocation))).intValue();

ClassName c = new ClassName();

v.addElement(c);
ClassName c = (ClassName)(v.elementAt(iLocation));

Parameterizing Raw to Generic Type

Vector<String> vecName = new Vector<String>();
JList<String> listName = new JList<String>();

List of Files
File f = new File(strDirectoryPath);
String[] strList = f.list(); // Includes all files in directory
String[] strList = f.list(new MyFilter); // Includes only “filtered” files

import java.io.FilenameFilter;
class MyFilter implements FilenameFilter {
public boolean accept(File fDirectory, String strFilename) {
if(…) return true;
return false;
}
}

WWW File Names

String strFileName = “http://www.amherst.edu/~fwesthoff/filename.txt”;

Font (java.awt.Font)
Font fontNew = new Font(strFontName, iFontStyle, iSize)
strFontName = Font.DIALOG, Font.MONOSPACED, Font.SERIF, Font.SANS_SERIF, …
iFontStyle = Font.PLAIN, Font.BOLD, Font.ITALIC, …

Exceptions
Throw(new Exception(“Exception message.”));
String strMessage = exc.getMessage();

Focus
component.requestFocusInWindow();

Unicode Characters
char cUnicode = 0x00A9 // 00A9 is the Unicode copyright symbol

Colors
Color colorNew = new Color(0xFF0000) // FF0000 is the red hex spec
 3

JDialog – Modal Mode

Calling routine
Dialog jDialog = new Dialog();
jDialog.getInformation();
jDialog.dispose();
Dialog
Constructor
this.setModal(true); // Don’t return until setVisible(false)
this.setVisible(true);

getInformation();
.
.
return information;

JList
JList<Class> list = new JList<Class>(); Class: String, Integer, …
list.setListData(Object[]);
list.setListData(Vector);
list.setListData(new Vector()) // clears list

list.setVisibleRowCount(iRows);

list.setSelectedIndex(iIndex);
list.setSelectedValue(“Value”), true); // true allows scrolling
int iIndex = list.getSelectedIndex();
str strEntry = (String)list.getSelectedValue(); // null if none selected

boolean3sum = (list.getModel()).getSize();
str strIndex = (String)(list.getModel()).getElementAt(iIndex);

JComboBox
JComboBox<Class> list = new JComboBox<Class>(); Class: String, Integer, …

jComboBox.addItem(iValue);
jComboBox.setSelectedIndex(iIndex)
jComboBox.getSelectedIndex()

jComboBox.addItem(str);
jComboBox.setSelectedItem(str);
str = (String) jComboBox.getSelectedItem();

Unicode
char cUnicode = 0x____;

Tuples
See TestTuple.java.
 4

JProgressBar
private void startTask() { // Call by the action button or whatever
// Set progress bar parameters
progressBar.setMaximum(100);
progressBar.setValue(0);
progressBar.setStringPainted(true); // Print text or percent completed
TaskInnerClass task = new TaskInnerClass();
textPane = new JTextPaneOutput(scrollPane_1);
task.start();
}
class TaskInnerClass extends Thread {
public void run() {
progressBar.setVisible(true);
runTask();
progressBar.setVisible(false);
}
}
private void runTask() {
progressBar.setValue(iIteration)
progressBar.setString(str); // Print str rather than percent completed

// Do the work
}

JFileChooserFilters
fcc.setFileFilter(new SpecialFileFilter());

class MySpecialFileFilter extends javax.swing.filechooser.FileFilter {

public String getDescription() {
return "Special files(*.*)";
}
public boolean accept(File f) {
String str = f.getName();
if(str.indexOf("~") < 0) return true;
return false;
}

Catching Key Strokes

public void jListPlayers_keyReleased(KeyEvent e) {
int iKeyCode = e.getKeyCode();
if(iKeyCode == KeyEvent.VK_UP || iKeyCode == KeyEvent.VK_DOWN) {

}
}

ButtonGroup
ButtonGroup bg = new ButtonGroup();
bg.add(jButton);

In Eclipse: Right click on button in the design window.

Scrolling
Swing Containers: JScrollPane
Put component in the JScrollPane
 5

Callbacks
// Specific method calls a general purpose method
// General purpose method needs info that is specific to the specific class

interface CallBackInterface {
public xxxx interfaceMethod(…); // “Placemark” for interface method
}

class InterfaceSpecificClass implements CallBackInterface { // MainClass

// Define interface method that provides interface info that is specific to this class
public xxxx interfaceMethod(…) {
// Code that is called by calling class
.
.
.
return vbl;
}

public specificMethodThatCallsGeneralPurposeMethod(…) {
GeneralPurposeClass generalPurposeClass = new GeneralPurposeClass(…);
generalPurposeClass.generalPurposeMethod(this, …);
}
}

class GeneralPurposeClass {
public xxxx generalPurposeMethod (CallBackInterface cbi, …) {
xxxx vbl = cbi.interfaceMethod(); // Get vbl info from interfaceMethod()
.
.
.
}
}

Interfaces
// Interface file
public interface InterfaceName
{
public xxxx interfaceMethod(…); // “Placeholder” for interface method
}

// The root class calls the interface method either in ClassToBeCallled1 or ClassToBeCalled2
Class RootClass
InterfaceName inter = new ClassToBeCalled1 or ClassToBeCalled2
inter.interfaceMethod(…);

Class ClassToBeCalled1 implements InferfaceName

public xxxx interfaceMethod(…) // Operative version of interface method
{
..
.
}

Class ClassToBeCalled2 implements InferfaceName

public xxxx interfaceMethod(…) // Operative version of interface method
{
..
.
}
 6

Abstract Classes
class CallingClass {
ClassAbstract classabs;

classabs = new ClassGeneric1();

or
classabs = new ClassGeneric2();

classabs.methodabstract()

public abstract class ClassAbstract {

abstract xxxs method();
}

public class ClassGeneric1 extends ClassAbstract {

public xxxx method() {
}
}
public class ClassGeneric2 extends ClassAbstract {
public xxxx method() {
}
}

Inner and Static Nested Classes

TestMainClass testMainClass = new TestMainClass();
TestMainClass.TestInnerClass testInnerClass = testMainClass.new TestInnerClass();
System.out.println(testInnerClass.subroutine());
System.out.println(TestMainClass.TestStaticNestedClass.subroutine());

public class TestMainClass {

public class TestInnerClass {
public String subroutine() {
return "TestInnerClass: subroutine()";
}

public static class TestStaticNestedClass {

public static String subroutine() {
return "TestStaticNestedClass: subroutine()";
}
}
}
 7

System
System.out.print(str);
System.out.println(str);

System.getProperty(str)
java.version Java Runtime Environment version
java.vendor Java Runtime Environment vendor
java.vendor.url Java vendor URL
java.home Java installation directory
java.vm.specification.version Java Virtual Machine specification version
java.vm.specification.vendor Java Virtual Machine specification vendor
java.vm.specification.name Java Virtual Machine specification name
java.vm.version Java Virtual Machine implementation version
java.vm.vendor Java Virtual Machine implementation vendor
java.vm.name Java Virtual Machine implementation name
java.specification.version Java Runtime Environment specification version
java.specification.vendor Java Runtime Environment specification vendor
java.specification.name Java Runtime Environment specification name
java.class.version Java class format version number
java.class.path Java class path
java.library.path List of paths to search when loading libraries
java.io.tmpdir Default temp file path
java.compiler Name of JIT compiler to use
java.ext.dirs Path of extension directory or directories
os.name Operating system name
os.arch Operating system architecture
os.version Operating system version
file.separator File separator ("/" on UNIX)
path.separator Path separator (":" on UNIX)
line.separator Line separator ("\n" on UNIX)
user.name User's account name
user.home User's home directory
user.dir User's current working directory

Terminating a Process
System.exit(iErrorCode) // Typically, iErrorCode = 0.
 8

FW Library Documentation

(FW) ConvertString
String[] ConvertString.toString(str, strDelimiter);
int[] ConvertString.toInteger(str, strDelimiter);
double[] ConvertString.toDouble(str, strDelimiter);
boolean[] ConvertString.toBoolean(str, strDelimiter); // strDelimiter: add + to eliminate empty cells

double[] ConvertString.stripComment(str[]);
double ConvertString.stripComment(str);

String ConvertString.clean(str);
String ConvertString.substring(str, iBegin, iEnd)

String ConvertString.replaceAllVector(str[], strOld, strNew);

String ConvertString.replaceUnderscores(str, strOld, strNew);

(FW) ConvertStringToArray
String[] ConvertStringToArray.toString(strSource);
String[] ConvertStringToArray.toString(strSource, strDelimitor);
int[] ConvertStringToArray.toInteger(strSource);
int[] ConvertStringToArray.toInteger(strSource, strDelimitor);
double[] ConvertStringToArray.toDouble(strSource);
double[] ConvertStringToArray.toDouble(strSource, strDelimitor);

(FW) FormattedOutput
String FormattedOutput.encode(iValue [,strAllign, iLength]);
String FormattedOutput.encode(dValue, iLength);
String FormattedOutput.encode(dValue, strAllign, iLength, iDecimals);
String FormattedOutput.encode(iBlanks);
String FormattedOutput.insertCommas(str);
String FormattedOutput.encodeDollarsAndCents(dValue [,strAllign, iLength]);

(FW) JavaMail
JavaMail(strMailServer, strSender, strAddressee, strMessage) throws Exception
boolean isMailOK();

(FW) Clipboard
Clipboard.setText(this, str);
String Clipboard.getText(this);

(FW) JWindowUtility
JWindowUtility.center(parentWindow, window);
JWindowUtility.center(window);
JWindowUtility.resizeForInsets(window);
boolean JWindowUtility.resizeComponent(jComponent, bWidth, bHeight);
String JWindowUtility.getMyDocumentsPath(strDirectory);
String JWindowUtility.getMyDocumentsPath();
String JWindowUtility.constructTitle(strModule, strVersion, strFilename);
String JWindowUtility.constructTitle(strModule, strVersion);
 9

(FW) DateTimeAux
long lTime = DateTimeAux.getTime(); // Get current time
long lTime = DateTimeAux.getTime(lMilliSeconds);
long lTime = DateTimeAux.getTime(iYear, iMonth, iDay, iHour, iMinute, iSecond) ;

str = DateTimeAux.formatDate(lMilliSeconds);
str = DateTimeAux.formatDate(lMilliSeconds, strSeparator);
str = DateTimeAux.formatTime(lMilliSeconds);
str = DateTimeAux.formatTime(lMilliSeconds, strSeparator);

int[] = DateTimeAux.getDate(lMilliSeconds);
int[] = DateTimeAux.getDateAndTime(lMilliSeconds);

int = DateTimeAux.getDayOfWeek(lMilliSeconds);

(FW) Sorters
void Sorters.sortArray(strArray);
void Sorters.sortArray(iArray);
void Sorters.sortArray(lArray);
void Sorters.sortArray(dArray);

void Sorters.sortArray(iLength, strArray);

void Sorters.sortArray(iLength, iArray);
void Sorters.sortArray(iLength, lArray);
void Sorters.sortArray(iLength, dArray);

int[] Sorters.sortArrayIndices(strArray);
int[] Sorters.sortArrayIndices(iArray);
int[] Sorters.sortArrayIndices(lArray);
int[] Sorters.sortArrayIndices(dArray);

int[] Sorters.sortArrayIndices(iLength, strArray);

int[] Sorters.sortArrayIndices(iLength, iArray);
int[] Sorters.sortArrayIndices(iLength, lArray);
int[] Sorters.sortArrayIndices(iLength, dArray);

(FW) Html Utilities

String HtmlCodeUtility.tableToString(String str);
String HtmlCodeUtility.trimHtmlTable(String strTable);

String HtmlCodeUtility.getHtmlLines(FileAsciiRead far, String strStart, String strStop);

strStart = “FirstStartString`SecondStartString`_”); _ indicates a line skip
strEnd = “FirstStopString`SecondStopString`_”); _ indicates a line skip
strEnd = “”; return immediately
NB: If only one start and stop string no grave accenst are needed.

String HtmlCodeUtility.stripHtmlCode(String str);

(FW) JQueryBox
JQueryBox qb = new JQueryBox(strTitle, strMessage, strLabel);
JQueryBox qb = new JQueryBox(strTitle, strMessage, strLabelArray);
qb.isButton(strLabel);
qb.dispose();
 10

(FW) Running a Jar File

JarUtility.runJar(strJarPath, bParentWait, bParentDispose);

(FW) Copy a File from the Web

JWebCopyUtility webCopy = new JWebCopyUtility(null, progressBar);
webCopy(strWebPath, strPCPath, strFileNameExt);
webCopy.setVisible(true);

(FW) Directory History

JDirectoryHistory dh = new JDirectoryHistory(strDirectoryHistoryFilename);
For example, JDirectoryHistory dh = new JDirectoryHistory(“Econ55);
This is a text file that is in the My documents directory My Histories
DirectoryHistory dh = new DirectoryHistory(strDirectoryHistoryFilename);
String strLastDirectory = dh.getLastDirectory();
strLastDirectory ends with a back slash, \.
dh.saveLastDirectory(jchooser);
public void this_windowClosing(WindowEvent e) {
dh.saveLastDirectory(jchooser);
}
dh.saveLastDirectory(strFileDirectory);

(FW) JTextPaneOutput
JtextPaneOutput jTextPane = new JtextPaneOutput(jScrollPane);

jTextPaneOutput.setText(str);
jTextPaneOutput.append(str);

jTextPaneOutput.clearAttributes();

jTextPaneOutput.setForegroundColor(c);

jTextPaneOutput.setBold(bool);
jTextPaneOutput.setItalics(bool);
jTextPaneOutput.setUnderline(bool);

jTextPaneOutput.setFontFamily(str); // Serif, Sansserif, Monospace, Dialog

jTextPaneOutput.setFontSize(int);

jTextPaneOutput.setSubscript(bool);
jTextPaneOutput.setSuperscript(bool)

jTextPaneOutput.setTab(int);
jTextPaneOutput.setTabs(int[]);
jTextPaneOutput.setTabs(int[], strAlign[]); // strAlign “l”, “r”, “c”, “d”

jTextPaneOutput.setLeftIndent(int)
jTextPaneOutput.setAlignment(strAlign); // strAlign “l”, “r”, “c”, “d”
 11

(FW) JGraph
JGraph graph = new JGraph(label, strAxisRange, strAxisNames, strAxisNumericalLabels);
strAxisRange = XMin YMin XMax YMax [XLabelDisplayFactor YLabelDisplayFactor]
strAxisNames = “XName YName”;
strAxisNumericalLabels = “ T/F T/F”;
JGraph graph = new JGraph(label, strAxisRange);
drawAxes();

setPointDiameter(iPointDiameter) // 8 is a good value

setPointColor(color);
drawPoint(dX, dY, iPointDiameter, color, strSpec);
strSpec
X: draw line from point to x-axis
Y: draw line from point to y-axis
R: draw line from point to the extreme right of graph
U: draw line from point the top of graph
drawPoint(dX, dY [, iPointDiameter, color]);
drawPoint(dXYs[] [, iPointDiameter, color]);

setLineWidth(iLineWidth) // 1 is the default

drawLine(dX0, dY0, dX1, dY1 [, iLineWidth, color]);
drawLine(dX, dY, dSlope [, iLineWidth, color]);
drawLine(dXYs[][] [, iPointDiameter, color]);
drawLineEquation(dCoefX, dCoefY, dConst [, iLineWidth, color]);

drawCurve(CurveInterface curveInterface, dXMin, dXMax, dXIncrement);

drawCurve(CurveInterface curveInterface, dXMin, dXMax [, iLineWidth, color]);

drawPolygon(dXs[], dYs[] [, iLineWidth, color]);

fillPolygon(dXs[], dYs[] [, color]);

setFontName(strFontName);
setFontColor(color);
setFontSize(iFontSize);
drawString(str, dX, dY, cPosition [, iFontSize, color]);
cPosition
U or ^: above and center horizontally
D or _: below and center horizontally
L or <: left and center vertically
R or >: right and center vertically
blank: right and no centering
getStringHeight(str);
getStringWidth(str);

double[] getMouseXYCoordinates();
Use WindowBuilder to add a motion listener to graph label;
then add call to getMouseXYCoordinates() to get mouse coordinates:
label.addMouseMotionListener(new MouseMotionAdapter() {
@Override
public void mouseXXXX(MouseEvent e) { // XXXX: Dragged, Pressed, …
dMouseXYCoordinates = graph.getMouseXYCoordinates();
}
});
 12

(FW) Draw Curve Example

class XXXXProcessResults implements CurveInterface { // MainClass
public drawGraph(…) {
drawCurve(this, dXAxisMin, dXAxisMax [, iLineWidth, color]);
}

public double calCurveYFromX(double dX) {

// Calculate dY;
return dY;
}
}

(FW) JarUtility – Static routine

void JarUtility.runJar(strPath, bParentWait)

(FW) JWebCopyUtility
JWebCopyUtility(progressbar)

copyFile(strUrlPath, strPCPath)
 13

(FW) File Utilities

boolean isOSMac()
boolean isOSWindows()

String getDocumentsPath()
String getDocumentsPath(strDirectory)

String correctFileSeparator(strFilePath)

String documentsPath(strDocDir, strFileName, strFileExt)

String documentsPath(strDocDir, strFileNameExt)
String documentsPath(strDocDirFileNameExt)

String webPath(strHttpDir, strFileName, strFileExt)

String webPath(strHttpDir, strFileNameExt)
String webPath(strHttpDirFileNameExt)

String genericPath(strFullDir, strFileName, strFileExt)

String genericPath(strFullDir, strFileNameExt)

String[] getFileDirectoryNameExtension(strFilePath)
String getFileDirectory(strFilePath)
String getFileName(strFilePath)
String getFileExtension(strFilePath)

boolean existsFile(strFilePath)
boolean existsDirectory(strDirectoryPath)

long lastModified(strFilePath)
void setLastModified(strFilePath, lDate)

boolean renameFile(strFilePathInput, strFilePathOutput)

boolean deleteFile(strFilePath)
void copyFile(strFilePathInput, strFilePathOutput) throws Exception
void copyFile(strFilePathInput, strFilePathOutput, lBufferMax) throws Exception

boolean createDirectory(strDirectory)
boolean removeDirectoryTree(strDirectory)
boolean removeDirectory(strDirectory)

String[] getListOfFiles(strDirectory)
String[] getListOfDirectories(strDirectory)

String stripAndAppendSeparator(str)
String appendSeparator(str)
String stripSeparator(str)

String abbreviateFilePathName(strFilePathName)
 14

(FW) Ascii File Read (Both Applications and Applets)

try {
FileAsciiRead far = new FileAsciiRead(strFilePath);

String str;
while( (str = far.readLine()) != null) {
// process
}
far.close();
}
catch (Exception e) {
String str = e.toString() ;
}

(FW) Ascii File Write (Both Applications and Applets)

try {
FileAsciiWrite faw = new FileAsciiWrite (strFileName);

faw.println(str);
faw.flush();
faw.close();
}

(FW) Object File Read (Both Applications and Applets)

try {
FileObjectRead for = new FileObjectRead(strFileName);

double[] dVector = (double[])for.readObject();

String[][] strArray = (String[][])fori.readObject();
}

(FW) Object File Write (Both Applications and Applets)

try {
FileObjectWrite fow = new FileObjectWrite(strFileName);

double[] dVector;
fow.writeObject(dVector);

String[][] strArray;
fow.writeObject(String[][]);

fow.flush();
fow.close();
}
 15

(FW) Random Access File Read (Applications Only)

try {
FileRandomRead frr = new FileRandomRead(strFileName);

Long lPointer = frr.getFilePointer();

frr.seek(lPointer);

int iValue = frr.readInt();

double dValue = frr.readDouble();

byte[] bArray = new byte[nLocs];

frr.readFully(bArray);

String str = frr.readUTF();

boolean bValue = frr.readBoolean();
}

(FW) Random Access File Write (Applications Only)

try {
FileRandomReadWrite frrw = new FileRandomReadWrite(strFileName);

Long lPointer = frrw.getFilePointer();

frrw.seek(lPointer);

frrw.writeInt(iValue);
frrw.writeDouble(dValue);

frrw.write(bArray);

frrw.writeUTF(str)
frrw.writeBoolean(bValue);
}
 16

(FW) JFileChooserCheckApplication1
JFileChooserCheckApplication fcca = new JFileChooserCheckApplication();
JFileChooserCheckApplication fcca = new JFileChooserCheckApplication(strExtension);
JFileChooserCheckApplication fcca = new JFileChooserCheckApplication(strExtensionArray);

String fcca.getFilePath(bMustExist); // Null if no file selected

Must be called to activate.

fcca.setMultiSelection(b);
String[] = fcca.getFilePaths(b); // String.length = 0 if no file selected

String fcca.getFileName();
String fcca.getTitle(strTitle);
boolean fcca.isApplication();

(FW) JFileChooserCheckApplet
JFileChooserCheckApplet fcca =
new JFileChooserCheckApplet(strWebLocation, strDirectoryFileName);
strWebLocation = http://....
strDirectoryFileName:
Description for File 1 File1Name.Ext
Description for File 2 File2Name.Ext

String fcca.getFilePath(bMustExist); // Null if no file selected

Must be called to activate.

String fcca.getFileName();
String fcca.getTitle(strTitle);
boolean fcca.isApplication();

Using (FW) JFileChooserCheckInterface for Applications or Applets

facca = new JFileChooserCheckApplication(…) or JFilechooserCheckApplet(…)
MyClass myClass = MyClass(facc)

1
Swing: (FW) JFileChooserCheck (Used by JFileChooserApplication)
JFileChooserCheck fcc = new JFileChooserCheck();
JFileChooserCheck fcc = new JFileChooserCheck(bMustExist);
JFileChooserCheck fcc = new JFileChooserCheck(bMustExist, strExtension);
JFileChooserCheck fcc = new JFileChooserCheck(bMustExist, strExtensionArray);

fcc.setTitle(strTitle);
fcc.setFileExtension(strExtension);
fcc.setFileExtension(strExtensionArray);
fcc.setFileMustExist(bMustExist);
fcc.setVisible(true/false);

File fcc.getFile(); // Null if no file selected

Must be called.

String fcc.getFilePath();
String fcc.getFileDirectory();
String fcc.getFileName();
String fcc.getFileExtension();
 17

(FW) JSpreadSheet
Column and Row Notation
strColumnNames[0] strColumnNames[1] strColumnNames[2] …
strArray[0][0] strArray[0][1] strArray[0][2] …
strArray[1][0] strArray[1][1] strArray[1][2] …
strArray[2][0] strArray[2][1] strArray[2][2] …
If there are row names, the first strArray column, strArray[i][0], contains the names.

Class MyParentFrame implements JSpreadSheetInterface

First, create a JScrollPane.

Constructors: Two types – one for separate column names and array and one for entire spreadsheet
JSpreadSheet ss =
// Separate column names and data
JSpreadSheet(this, JScrollPane scrollPane, String[][] strArray, String[] strColumnNames,
boolean bLockFirstColumn, boolean[][] bCellEditable)
JSpreadSheet(this, JScrollPane scrollPane, String[][] strArray, String[] strColumnNames,
boolean bLockFirstColumn)
// NB: All strArray cells will be editable.
JSpreadSheet(this, JScrollPane scrollPane, String[][] strArray, String[] strColumnNames)
// NB: All strArray cells will be editable and first column is locked.

JSpreadSheet(this, JScrollPane scrollPane, String[][] strEntireSpreadSheet,

boolean bLockFirstColumn, boolean[][] bCellEditable)
JSpreadSheet(this, JScrollPane scrollPane, String[][] strEntireSpreadSheet,
boolean bLockFirstColumn)
// NB: All strArray cells will be editable.
JSpreadSheet(this, JScrollPane scrollPane, String[][] strEntireSpreadSheet)
// NB: All strArray cells will be editable and first column is locked.

// Interface routine:
public boolean isCellChangeValid(int iRow, int iColumn, String str) {
// When appropriate, use ss.isDouble() to check for valid entry.
..
.
}

// Auxillary routines:
ss.flush(); // Called to flush out last spread sheet entry
ss.isDouble(); // Used by isCellChangeValid to check for valid entry
ss.getDouble();
ss.clearSpreadSheet();
 18

(FW) FixedPointsIntegerDialog

class MyParentFrame implements FixedPointsIntegerInterface

double[] dPointFrom, double[] dPointTo;

FixedPointsIntegerDialog fpd = new FixedPointsIntegerDialog(
this, double[] dPointFrom, double[] dPointTo);
//fpd.setStopAfterMajorIteration(b); // The default is false

// Start and Stop

fpd.setVisible(true);
fpd.dispose();

// Interface routines:
public void getMappedPoint() {
..
.
}
public String getSummaryText() {
return null; for the default summary
..
.
 19

(FW) SimulationThread
class MyParent

Create the following:

• Start/Continue button
• Stop button
• Pause checkbox
• Repetitions label

// To set initial text, visibility, and enabling of buttons, checkbox, and label
// call this in the addNotify() method:
SimulationThread(Jbutton jButtonStartContinue, Jbutton jButtonStop,
JcheckBox jCheckBoxPause, Jlabel jLabelRepetitions);

// Start button clicked

if{thread == null) {
ParentThread thread = ParentThread(Jbutton jButtonStartContinue,
Jbutton jButtonStop, JcheckBox jCheckBoxPause,
Jlabel jLabelRepetitions, …);
}
thread.startSimulation();

// Stop button clicked

thread.stopSimulation();
thread = null;

class MyParentThread extends SimulationThread implements SimulationThreadInterface

public ParentThread(Jbutton jButtonStartContinue, Jbutton jButtonStop,
JcheckBox jCheckBoxPause, Jlabel jLabelRepetitions, …) {
super(Jbutton jButtonStartContinue, Jbutton jButtonStop,
JcheckBox jCheckBoxPause, Jlabel jLabelRepetitions, int iRepsPerPrint);
super(Jbutton jButtonStartContinue, Jbutton jButtonStop,
JcheckBox jCheckBoxPause, Jlabel jLabelRepetitions);

super.setInterface(this);
..
.
}

// Auxillary routines:
super.startSimulation();
super.stopSimulation();

// Interface routines:
public void runOneRepetition() {
..
.
}
public void reportResults() {
..
.
}
 20

(FW) FileManagement
class MyParentFrame implements JFileManagementInterface
Create the following:
• File JMenuBar, JMenu, JMenuItem
• The following menu items: New, Open, Save, SaveAs, and Close

MyFileClass myFileClass = new MyFileClass(strFileExtension, jMenuItemSave,

jMenuItemSaveAs, jMenuItemClose)

// Menubar action routines

myFileClass.newFile();
myFileClass.openFile();
myFileClass.saveFile();
myFileClass.saveAsFile();
myFileClass.closeFile();

class MyFileClass extends JFileManagement implements JFileManagementInterface() {

MyFileClass(String strFileExtension, JMenuItem jMenuItemSave,
JMenuItem jMenuItemSaveAs, JMenuItem jMenuItemClose)

// NB: One of the following two constructors is necessary

super(strFileExtension, jMenuItemSaveAs, jMenuItemSave, jMenuItemClose);
super(); // I don’t understand this one, unless the other items are unwanted.

// NB: The following call is necessary to set the interface class

super.setInterface(this);

NB: Typically, you want to pass the data entry class (e.g., the class that contains the
spread sheet to that this class can have access to the data.

// JFileManagement auxillary routines:

super.getFilePath();
super.getFileName();
super.changes(); // Informs JFileManagement that changes have occurred

// Interface routines:
public void initializeFile() { // Sets up and initializes the data classes
..
.
}
public void readFile() {
..
.
}
public void writeFile() {
..
.
}
public void clearFile() { // Don’t know what this does
..
.
}

// NB: bChanges must be set to true if any data are changed.

public boolean isChanged() { // Don’t know how this works
return bChanges;
}
 21

JEconLabUtility
(FW) JEconLabUtility.JEconLabSlider
class JEconLabUtility econLabUtility = new JEconLabUtility();
JEconLabUtility.JEconLabSlider slider = econLabUtility.new JEconLabSlider(scrollbar [, label, strPrefix])

init(strSpecs)
init(strSpecs, strPrefix) // strSpecs = “minimum maximum iteration default”

setSliderMinimum(strMinimum)
setSliderMinimum(strMaximum)
setSliderMinimum(strIncrement)
setSliderMinimum(strDefault)

setSliderPrefix(strPrefix)
setSliderDecimals(iDecimals)
setSliderVisible(bIsVisible)
setSliderValue(dValue)

getSliderInteger()
getSliderDouble()
getSliderString()

getSliderMinimum()
getSliderMaximum()
getSliderIncrement()
getSliderDefault()

isSliderValueEqual(dValue)
isSliderVisible()

updateSliderValue()

(FW) JEconLabUtility.JEconLabSearch
class JEconLabUtility econLabUtility = new JEconLabUtility();
JEconLabUtility.JEconLabSearch search = econLabUtility.new JEconLabSearch(sliderSearch
[, labelSearch, strSearchMessages])

init(strSearchMessages)

isSliderValueOptimal(dOptimalValue)

(FW) JEconLabUtility.JEconLabSearch
class JEconLabUtility econLabUtility = new JEconLabUtility();
JEconLabUtility.JEconLabSearch search = econLabUtility.new JEconLabSearch(sliderSearch
[, labelSearch, strSearchMessages])

init(strSearchMessages)

isSliderValueOptimal(dOptimalValue)

(FW) JEconLabUtility.JEconLabButtonGroup
class JEconLabUtility econLabUtility = new JEconLabUtility();
JEconLabUtility.JEconLabButtonGroup econLabButtonGroup =
econLabUtility.new JEconLabButtonGroup (buttonGroup);

updateButtonGroup(buttonSelected);
 22

(FW) JEconLabUtility.JEconResizeLabPanel – Static routines

JEconLabUtility.JEconResizeLabPanel.resizeLabPanel(frame, rectangle);

(FW) JEconLabUtility.JEconLabElasticityUtility – Static routines

double[] JEconLabUtility.JEconLabElasticityUtility.getPrecentChange(dInitial, dNew);

double[] JEconLabUtility.JEconLabElasticityUtility.ConvertElasticityToFunctionConstantAndSlope(
dElasticity, dQuantity, dPrice);
double[] JEconLabUtility.JEconLabElasticityUtility. ConvertElasticityToCurveInteceptAndSlope(
dElasticity, dQuantity, dPrice);

(FW) JEconLabUtility.JEconLabFunctionAndCurveUtility – Static routines

double[] JEconLabUtility.JEconLabDemandFunctionAndCurveUtility.calDemandCurveInterceptAndSlope(
dDemandFunctionConstant, dDemandFunctionOwnPriceCoef
[, dDemandFunctionCrossPriceCoef] );

double[] JEconLabUtility.JEconLabDemandFunctionAndCurveUtility.calDemandFunctionConstantAndSlope(
dDemandCurveIntercept, dDemandCurveSlope)

double[] calDemandFunctionConstantAndCoef(double dDemandCurveIntercept,

double dDemandCurveSlope)

(FW) JEconLabUtility.JEconLabProbSpecsTuple – Static routines

See LabTEMPLATEPane.java

(FW) JEconLabUtility.EconLabColors – Static variables

 Eclipse-Window Builder Help
November 11, 2018

Creating a project:
• Toolbar Menu: New icon’s drop down list (not the icon itself) – Java Project
• Specify the name of the project.
• Finish

Creating a frame, or applet, or …

• Highlight project.
• Toolbar Menu: New icon itself ( not the icon’s drop down list) – WindowBuilder – Swing
Designer – JFrame (for application) or JApplet
• Name frame or applet
• Specify package (if necessary) and name
• Finish
• Modify contentPane.setLayout(…) to contentPane.setLayout(null)
• Delete import java.awt.BorderLayout;
• Right click warning icon – Quick Fix – Add default serial ID

Creating a panel
• Apparently the WindowBuilder Designer does not work properly until one component has been
attached to the contentPane “by hand.” So, use the JPanelTemplate.java in the subdirectory
eclipse\Templates which includes btnDummy which can be deleted later.

Displaying panels
• Window (menu item) - Show View (drop down box)

Accessing WindowBuilder
• Right click Java file
• Open Java file - Open With – WindowBuilder Editor

Create a library Jar file and the Jar description file

• File (menu item): Select Export
• Export window: Select Java – JAR file
• JAR File Specification window
o Select the resources to export window: Select files to include in the library
o Select the export destination: Specify Jar file name. (I’m using the root directory of
FWLibraries for the location of the library files; also, check the export name.)
o Next
• JAR Packaging Options
o Be certain the Save the description of this JAR file in the workspace is selected
o Name Description file
• Finish

Create a library Jar file from a Jar description file

• Right double click Jar description file (*.jardesc)
• Finish

Add Libraries to Project

• Right click on project – Build Path – Configure Build Path…
• Properties for project: Click Add Jars
• Jar Selection window: Find and then click on the wanted library jar
The library will now be listed as part of the project.
 2

Create a Runnable Jar Application File and an Ant file: Produces a jar file that can be run as an
application or applet and an ANT file which can be used in the future to create the jar file.
• Highlight the “root” file for the application.
• File (menu item): Select Export
• Export window: Select Runnable JAR file
• Runnable JAR File Export window: NB: Be careful to specify the correct Launch
configuration, Export destination, and ANT script location. Eclipse saves the last ones so if
you are creating a new jar file you must change all three.
o Launch configuration: Select
o Export destination: Click Browse
o Library handling: Select “Extract required …”
o Save as ANT script: Check
o ANT script location: Click Browse
• Finish

Create a Runnable Jar Application File from an Ant file: Produces a jar file that can be run as an
application or applet
• In Eclipse, Right click the ANT file which has an xml extension.
• Click Run As
• Click 1 Ant Build

Creating Jar Files for Applets

• In the (package) source directory create a Java application that accesses the main class.
• Create a jar file for the application using the application’s launch configuration. (Note that the
applet does not have a launch configuration.
• The jar file can be run as an applet or application.

Adding a Project to a Working Sets

• Click the “triangle” in the top line of the Project Explorer
• Check the working set to contain the project
• Click Edit Active Working Set
• Select the project and click Add

Jar Creation Xml Ant files do not appear in Eclipse’s Project Explorer
• In Window’s Explorer, cut the files and paste to somewhere else.
• Cut the files from where they were pasted.
• In Eclipse, paste them to the appropriate project.

Jar Creation Xml Ant Script Problem

• Right click on your ant script
• Select Run as
• Select External tool configurations...
• Select JRE tab
• Select Run in the same JRE as the workspace
 3

Launch Configurations
• To determine which launch configuration an application is using:
o Run the application.
o Click Run in the Eclipse menu and then click Run Launch Configuration.
o The launch configuration used will be lightly highlighted.
• To determine if a launch configuration is being used by some application
o Click Run in the Eclipse menu and then click Run Launch Configuration.
o Double click on the launch configuration in question.
o If the launch configuration is being used, the application will run; otherwise and
error ensues.