Класс приложения предоставляет следующие функции:

— конечный автомат приложения: программный кодер может использовать простой конечный автомат приложения C³. Давайте начнем с двух состояний: «Работает» и «Закрыто». Подклассируя абстрактный класс Application, компилятор заставит вас реализовать события. Во время выполнения ваши события будут вызываться перед каждым изменением состояния,

— свойство приложения: приложение должно конфигурироваться пользователем программного обеспечения с использованием свойств Java (другой тип конфигурации может быть добавлен в будущей версии). Аннотация под названием @AppProperty обрабатывает эту функциональность просто декларативным образом, а C³ выполняет всю работу за вас.

— общая справка по автоматически документированному механизму: не нужно добавлять код для отображения названия приложения, информации «о» и свойств. C³ автоматически обнаруживает все функции приложения и отображает их, когда пользователь программного обеспечения добавляет параметр «-help» в команду запуска программного обеспечения.

Аннотация заявки

C³ предоставляет механизм аннотации приложения, в котором можно установить версию и добавить текст «о программе». Эта информация будет доступна пользователю программного обеспечения.

@AppInformation (version="1.0", about="This a Hello world application with C³")
public class HelloWorldApplication extends Application {
}

Конечный автомат

 В нашем простом примере C³ предоставляет конечный автомат приложения только с двумя состояниями: «Работает» и «Закрыт». Непосредственно перед достижением одного из двух состояний C³ уведомит вас соответствующим событием: notifyApplicationToBeRun или notifyApplicationToBeClosed.
Первое событие вызывается, когда все свойства AppProperties готовы, и когда создаются компоненты. Будущая статья будет посвящена компонентам. По сути, это событие должно использоваться для настройки и запуска вашего приложения.
Второе событие вызывается, когда приложение остановлено. C³ обнаруживает, что ваша заявка закрывается, и уведомляет об этом. Событие можно использовать для правильного закрытия ресурсов, таких как сокет, база данных, файл и т. Д.

@AppInformation (version="1.0", about="This a Hello world application with C³")
public class HelloWorldApplication extends Application {
    @Override
    public void notifyApplicationToBeRun(String applicationDescrition, String componentsDescription) {
        System.out.println("Application started");
    }
    @Override
    public void notifyApplicationToBeClosed() {
        System.out.println("bye bye, application closed");
    }
}

AppProperty аннотация

Язык Java предоставляет системное свойство, которое можно установить либо в командной строке Java с префиксом «-D», либо путем загрузки файла свойств. Свойство — это пара ключ / значение, где каждое значение доступно через связанный ключ.

C³ предоставляет аннотации для автоматической привязки свойства к вашему члену приложения класса. Принцип является основным, будучи декларативным. Таким образом, код более функциональный и менее технический. То, что вам нужно сделать, это добавить в качестве члена класса необходимую конфигурацию внутри вашего класса приложения. Например, предположим, что приложение должно быть настроено с именем приветствия. Все, что вам нужно сделать, это добавить внутри подкласса вашего собственного приложения такой член, как:

@AppProperty
String name = "World";

Приведенный выше фрагмент кода можно прочитать так: это свойство называется «name», а его значением по умолчанию является «world». Автоматически системное свойство «name» доступно для настройки вашего приложения.

Минимальное и максимальное значение могут быть добавлены для некоторых числовых свойств

@AppProperty(comment = "primitive value", min = 3, max = 7)
int intValue1 = 5;

Поддерживаемые типы элементов приложения перечислены в следующей таблице:

Дополнительные типы могут быть легко добавлены путем реализации универсального интерфейса ObjectFactoryFromStringValue, который должен возвращать определенный универсальный тип из строки. Когда фабрика написана, просто добавьте ее с помощью следующего метода при создании приложения.

public void addNewObjectFactory(Class objectFactoryType, ObjectFactoryFromStringValue factory)

C³ предоставляет параметры команды по умолчанию, такие как ключевое слово «-help», «-h», «–help» или «–h». При вызове с одним из этих параметров C³ записывает в системный вывод:

• название приложения,
• «О» информации,
• версия приложения
• список свойств, с их типами.

You can either use your own code typed from the samples or download the ready to use classes