Anatomy of a Granitic application

Granitic applications are built from three main resources:

  • Go source code
  • Component definition files
  • Configuration files

Go source code

Your application will define its application logic in Go source files. There is no restriction on how you structure your code in terms of packages and source files. The only two restrictions are:

  1. Your application needs a main method in which it can pass control to Granitic
  2. The Granitic IoC container expects to manage components that are instances of structs so your application logic needs to be represented as structs.

Minimal ‘main’ file

package main

import ""
import "path/to/your/project/bindings"  

func main() {

This example file provides a main function for Go and passes control to Granitic using the StartGranitic function. This allows Granitic to have full control over the parsing of command line arguments. If your application needs to parse it’s own command line arguments, refer to the GoDoc for alternative ways to start Granitic

Component definition files

A component is a named instance of a struct that Granitic will instantiate and configure on behalf of your application. Component definition files are JSON (or YAML) files that contain the name, type and some of the configuration for that component. For example:

  "artistHandler": {
      "type": "handler.WsHandler",
      "HttpMethod": "GET",
      "Logic": "ref:artistLogic",
      "PathPattern": "^/artist"

is the definition for a handler component that can receive web service requests. Your application must include at least one component definition file.

The structure and capabilities of these files are described in detail here

Configuration files

Granitic applications are designed such that no configuration is include in the compiled exectuable created when you go build your application. Instead you provide configuration as JSON files that are loaded when your application starts. The usage of configuration files is described in detail here.

Default locations

By default, Granitic expects to find the following directory structure in your project root:


But this is only a convention and the tools that interact with component definition files and configuration files accept alternative locations for these files.

Next: Creating a new project

Prev: Granitic projects