skyfoundry / sample-user-mgr

Sample User Manager

Sample User Manager

This repo contains skeleton code for implementing a sample project that builds a basic CRUD UI to edit a database of users using Fantom and DomKit.

Setup

This repo contains a fan.props file which creates its own local PathEnv. You can verify this by running fan -version:

sample-user-mgr$ fan -version
Fantom Launcher
Copyright (c) 2006-2019, Brian Frank and Andy Frank
Licensed under the Academic Free License version 3.0

Java Runtime:
  ...
  fan.env:         util::PathEnv
  fan.home:        /Users/andy/proj/fan/dev

Env Path:
  /Users/andy/proj/sf/sample-user-mgr (work)
  /Users/andy/proj/fan/dev (home)

The fan.home value should point to your Fantom installation and your Env Path should include your fork of this project.

Building

This project will compile and run out-of-the-box to make it easy to start filling in the missing pieces.

To compile:

sample-user-mgr$ src/sampleUserMgr/build.fan

To run:

sample-user-mgr$ fan sampleUserMgr
[11:00:39 23-Dec-19] [info] [web] http started on port 8080

Point your browser to http://localhost:8080 to load the page.

Implementation Notes

• The dom chapter covers practical API usage for the core DOM pod, including HttpReq.

• The docDomkit chapter covers the high level overview as well as practical examples of all the DomKit APIs.

• See Table section for details on wiring up domkit::Table

• User demo data is available under data/users.csv

• See CsvInStream and CvsOutStream for APIs to read and write CSV data.

• Start with UserMgr.onInit to wire up data/users.csv into the main domkit::Table instance.

• See NewUser for skeleton code for creating and laying out controls in a dialog box.