Aussom Lang - Aussom Server

What It Is

Aussom Server is a lightweight HTTP server purpose-built for running Aussom web applications. Define routes as class methods, serve templates with Handlebars, and build APIs in a language designed for clarity and safety.

Key Features

Convention-Based Routing. Public methods in your app class become HTTP endpoints automatically. No route configuration files or annotation boilerplate.
Handlebars Templating. Server-side HTML generation with the built-in Handlebars module. Compile templates once and apply data objects to produce pages.
Database and Integration Ready. JDBC for relational databases, SSH for remote operations, HTTP client for external APIs, SendGrid for email. Connect to the services your application needs.
Full Stack with Aussom-Script. Serve pages that use Aussom-Script on the client side. One language from database to browser.

Who It Is For

Backend developers building web applications and APIs who want a lightweight, Aussom-native alternative to traditional Java application servers.

Getting Started

Review the Aussom Server API reference in the sidebar to understand the request handling model and available modules. The AppBase class is the foundation for every Aussom Server application.

Guides

Aussom Server Usage

Install Aussom Server via zip file and use locally and for development.

Docker Image Usage

Install Aussom Server via Docker Image or upgrade an existing installation.

OpenAPI Annotations Usage

Using API Annotations and generating the OAS specification.

Websocket Usage

Guide on how to use websockets in Aussom Server.

Firebase Usage

Connect Aussom Server applications to Firebase for auth, Firestore, and messaging.

Language Overview

What Aussom is, how its pieces fit together, and a map of the rest of these docs.

Variables

Local versus member variables, public and private access modifiers.

Data Types

The nine built-in types: null, bool, int, double, string, list, map, callback, object.

Functions

Defining and calling functions, default and variadic arguments, type annotations, set blocks.

Control Flow

if / else if / else, switch / case, while, and for loops including list and map iteration.

Operators

Math, string, list and map operators, the safe-access ?, and operator precedence.

Classes

Constructors, inheritance (single and multiple), static classes, instanceof.

Exception Handling

try / catch, the exception object methods, throw, and when to let exceptions propagate.

Modules

Splitting code across files with include, dotted module paths, and delayed includes.

Extern Classes

How Aussom calls into Java code, what extern declarations look like, and inheritance rules.

Standard Library

Tour of the modules that ship with the interpreter, plus what each runtime adds on top.

Style Guide

Naming conventions, formatting, and Aussom-Doc comments. Apply across all .aus code.

Annotations Guide

Attach metadata to classes, members, and methods. Read it back through the reflect module.