AndroidLayouts

The AndroidLayouts is a Java library that uses a Java DSL, AndroidLayoutsApi, to write valid Android visual layouts. The elements and rules of this language are defined in a XML Schema Definition file, i.e. XSD file, and those language rules were used to create a Java DSL using XsdAsmFaster.

Installation

First, in order to include it to your Maven project, simply add this dependency:

<dependency>
    <groupId>com.github.xmlet</groupId>
    <artifactId>androidLayouts</artifactId>
    <version>1.0.1</version>
</dependency>

How does AndroidLayouts works?

This library consists of three classes:

• Android - Receives a function that will create the visual layout.
• AndroidVisitor - Provides an implementation of the ElementVisitor class. This implementation writes and indents XML based on the classes and attributes that are present in the element tree.
• Indentation - Helper class used for perfomance.

Usage

In the following code snippet we have the required code to generate a layout, which is shown below the code.

class Example{
    void example(){
        Android android = new Android(androidObj ->
            androidObj.layout()
                .linearLayout()
                    .attrOrientation(EnumOrientationLinearLayout.VERTICAL)
                    .attrLayoutWidth("match_parent")
                    .attrLayoutHeight("wrap_content")
                    .linearLayout()
                        .attrOrientation(EnumOrientationLinearLayout.HORIZONTAL)
                        .attrLayoutWidth("match_parent")
                        .attrLayoutHeight("wrap_content")
                        .imageView()
                            .attrLayoutWidth("wrap_content")
                            .attrLayoutHeight("wrap_content").__()
                        .textView()
                            .attrWidth("match_parent")
                            .attrHeight("weight_content")
                            .attrLines("2").__()
                    .__()
                .__());

        String result = android.getLayout();
    }
}

<LinearLayout
	android:orientation="vertical"
	android:layout_width="match_parent"
	android:layout_height="wrap_content">
	<LinearLayout
		android:orientation="horizontal"
		android:layout_width="match_parent"
		android:layout_height="wrap_content">
		<ImageView
			android:layout_width="wrap_content"
			android:layout_height="wrap_content"/>
		<TextView
			android:width="match_parent"
			android:height="weight_content"
			android:lines="2"/>
	</LinearLayout>
</LinearLayout>

As we can see from the previous example, this library provides a very similar way to write valid layouts, the flow of the creation of the layout being very similar to the flow of writing XML, while guaranteeing that the rules of the creation of Android layouts are verified.