Development - Floreant POS :: Open Source Point of Sale

Download source code

You can either download the full source code as tarball from here

Or use subversion client to obtain full source code.

svn checkout svn://svn.code.sf.net/p/floreantpos/code/trunk floreantpos-code

Setup Maven & Compile

Get sure you have installed JDK latest version.
Follow famous 5 minutes maven tutorial and install maven
go to the floreantpos-code folder and from command line type
mvn clean
mvn package
It will rebuild the whole package. You should find the compiled jar file in
target/floreantpos-bin/floreantpos folder

Prerequisites:

Decide if you want to develop with 64-bit or 32-bit tools. Make sure you download all of one type. Try 64-bit if unsure.

Make sure you have a Java Runtime Environment (JRE)

Make sure you have a Java SE Development Kit (JDK)

Installing/configuring Eclipse

Note: Below instructions are the main points. There are several dialogs/options not discussed. If you see one you’re not sure what to do with, just accept the defaults.

Download Eclipse IDE for Java Developers

Extract the zip, put the eclipse directory where you like

Run the eclipse application

Update eclipse by: click Help then Check for Updates

Update the Maven plugin by:

Click Help then Eclipse Marketplace…

Type Maven in the Find box and click the magnifying glass

Disregard the results and click the Installed tab. [Note: This is an odd way of doing things because of a quirk in Eclipse. If you click Installed without first doing the search, Installed will erroneously show that no plugins are installed.]

Click the Update button for Maven Integration for Eclipse (Luna) 1.5.0

Install SVN support using the Subversive – SVN Team Provider 3.0.0 plugin by:

Click the Popular tab

Click the Install button for Subversive – SVN Team Provider 3.0.0

Select the option to install Subversive SVN Integration for the M2E Project (Optional) and click Confirm

Developing Floreant

File, Import, SVN, Project from SVN

A dialog to choose SVN external connectors pops up. Pick the top two, Java connectors for 1.7 and 1.8

Restart eclipse as prompted and import SVN again. Important: Make sure you notice the Check Out As dialog as you move through the import process (step 4 below.) URL is: svn://svn.code.sf.net/p/floreantpos/code. Note: When prompted aboutRevision, Head Revision is the most recent version of the repository.

When you see the Check Out As dialog, select the second option, Find projects in the children of the selected resource

Once import is complete, right click on the project, click Maven and Update Project…

Right click on the project, Run As, and 2 Java Application. The Java Application is Main – com.floreantpos.mainInstructions as of July 2015 based on Windows OS

[ Courtesy: Kraig / Floreant Forum]

Develop in netbean IDE

Steps:
[ We no longer use NetBean. This is a user submitted tutorial and it may be outdated]

Create a New Project Workspace
Download source code from subversion
Copy Source Code and Libraries
Update Project settings
Compile & Test
Database Setup

Create a New Project Workspace

Open the folder where you have your source code

Now you should find a new workspace created with default code. For example D:\Mundel\POSWorkspace\POS

Download source code from subversion

Copy Source Code and Libraries

Copy the scr and lib folder to your workspace ( for ex : D:\Mundel\POSWorkspace\POS). You can overwrite default scr & lib folder

Update Project settings

Right click on workspace name /project name. Here we named it “POS”

click on “Properties”

Add libraries. Click on “Libraries” link in the sidebar and add jar/Folder.

Libraries are found in “lib” folder in your source code.

Set Entry point of code. In Floreant POS main function is com.floreantpos.main.Main. Click on “Run”, change the Main Class to “com.floreantpos.main.Main”.

Compile & Test

Now you compile & run changed code from NetBean Menu ( Run -> Run Main Project). Remember to “Clean and Build Main Project” before you do that. And also you need to start Database server to make application working.

Secret code : 1111

Database Setup

You can use your favorite database utilities but NetBean latest release has full support for JavaDB . For other options visit

If you are in trouble with Java DB installation follow http://netbeans.org/kb/docs/ide/java-db.html

In floreant POS, database resides in “posdb” folder, so copy posdb folder or point to that path

Database name: posdb (same as the folder name)
User name: app
password: sa

From IDE select jdbc:derby://localhost:51527/posdb

Starting Database server
Double click over JavaDB menu to start and stop Database server.

When you are done overwrite posdb folder of your Project that you have downloaded from Subversion
Warning: posdb should not contain another posdb folder, it should contain the files

If you have successfully connected by right clicking on “jdbc:derby://localhost:51527/posdb” you should see

You can navigate through Databse tables

If you have any problem you can check if JDK is installed properly.

This tutorial is originally written in 2010 by Indokely and may differ from later version of Netbean editor.

Manually Accessing Database

Our database schema is subject to chage. You can directly access database with DBeaver SQL client.

💡 Default DB is apache derby, database: posdb, user: app, password: sa

ER Diagram

Click the following image and zoom in to see full view.

Previous tab Next tab