Navigator

General

Category
Free
Tag
APT
License
GNU Lesser General Public License, Version 2.1
Registered
Sep 2, 2015
Favorites
1
Link
https://github.com/aradomski/Navigator
See also
Akatsuki
Android-ParseModel
MethodScope
XmlTag
AutoCursor

Additional

Language
Java
Version
N/A
Created
Aug 31, 2015
Updated
Feb 4, 2016 (Retired)
Owner
Adam Radomski (aradomski)
Contributor
Adam Radomski (aradomski)
1
Activity
Badge
Generate
Download
Source code

Blurb

Navigator

Navigator code generator for Android. This library creates boilerplate code useful to start new activities.

Provides Navigator class that keeps all start activity methods with appropriate parameters.

Provides *ParamLoader classes for easy loading parameters from Intents

Provides *ResultFiller classes for easy returning values from Activities by filling Intents

Provides *ResultLoader classes for easy loading results from Activities

Provides *Result classes for keeping results from Activities

##I want to:

Get library from maven and include it in my project

navigator-compiler

navigator-annotations

In project build.gradle file add:

classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'

On top of module build.gradle file add:

apply plugin: 'com.neenbedankt.android-apt'

then add:

 compile 'pl.edu.radomski:navigator-annotations:1.0.0'
 apt 'pl.edu.radomski:navigator-compiler:1.0.3'

in dependencies

Navigate to simple activity

@Navigable
public class SimpleActivity extends Activity 
Navigator.simpleActivity(Activity.this);

Navigate to activity with params

@Navigable
public class ParamsActivity extends Activity {

  @Param
  Integer integerParam;
  @Param
  String stringParam;
  @Param
  Book parcelableParam;


  @Override
  protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      ParamsActivityParamLoader.load(this);
  }
}
Navigator.paramsActivity(Activity.this, 2123, "abcdefgh", book);

Navigate to activity with various groups of params

@Navigable
public class GroupedParamsActivity extends Activity {

    @Param(group = "firstGroup")
    String stringParam;
    @Param(group = "firstGroup")
    Boolean booleanParam;
    @Param(group = "secondGroup")
    Double doubleParam;
    @Param(group = "secondGroup")
    Integer integerParam;


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        GroupedParamsActivityParamLoader.load(this);
    }
}
Navigator.groupedParamsActivity(Activity.this, 32.12, 2145);
Navigator.groupedParamsActivity(Activity.this, "abcdefgh", true);

Start Activity for result

@Navigable
public class ForResultActivity extends Activity {
    @Result
    String stringResult = "abcdefghijk";
    
    @Override
    protected View.OnClickListener getOnCloseClickListener() {
        return new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Intent intent = ForResultActivityResultFiller.fillResult(ForResultActivity.this);
                setResult(RESULT_OK, intent);
                finish();
            }
        };
    }
}
Navigator.forResultActivityForResult(Activity.this, 123);
 ForResultActivityResultLoader.ForResultActivityResult result3 = ForResultActivityResultLoader.load(data);

Start parameterized Activity for result

@Navigable
public class ParamsForResultActivity extends Activity {

    @Param(forResult = true)
    Integer integerParam;
    @Param(forResult = true)
    String stringParam;
    @Param(forResult = true)
    Book parcelableParam;

    @Result
    String stringResult = "result";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ParamsForResultActivityParamLoader.load(this);
    }  
    
    @Override
    protected View.OnClickListener getOnCloseClickListener() {
        return new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Intent intent = ParamsForResultActivityResultFiller.fillResult(ParamsForResultActivity.this);
                setResult(RESULT_OK, intent);
                finish();
            }
        };
    }
}
  Navigator.paramsForResultActivityForResult(Activity.this, 123, "abcdefgh", book, 737);
 ParamsForResultActivityResultLoader.ParamsForResultActivityResult result1 = ParamsForResultActivityResultLoader.load(data);

Start activity for various results

@Navigable
public class GroupedResultsForResultActivity extends BaseActivity {

    @Param(forResult = true)
    Integer returnGroup;

    @Result
    String stringResult = "string result";
    @Result(group = "firstGroup")
    Boolean booleanResult = true;
    @Result(group = "secondGroup")
    Double doubleResult =123.5;
    @Result(group = "secondGroup")
    Integer integerResult= 6523;


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        GroupedResultsForResultActivityParamLoader.load(this);
        StringBuilder stringBuilder = new StringBuilder();
        stringBuilder.append(this.getClass().getCanonicalName());
        stringBuilder.append("\n");
        stringBuilder.append(this.toString());
        classInfo.setText(stringBuilder);
    }

    @Override
    protected View.OnClickListener getOnCloseClickListener() {
        return new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Intent intent = null;
                switch (returnGroup) {
                    case 1:
                        intent = GroupedResultsForResultActivityResultFiller.fillResult(GroupedResultsForResultActivity.this);
                        break;
                    case 2:
                        intent = GroupedResultsForResultActivityResultFiller.fillResultfirstGroup(GroupedResultsForResultActivity.this);
                        break;
                    case 3:
                        intent = GroupedResultsForResultActivityResultFiller.fillResultsecondGroup(GroupedResultsForResultActivity.this);
                        break;
                }
                setResult(RESULT_OK, intent);
                finish();
            }
        };
    }
}
 Navigator.groupedResultsForResultActivityForResult(BaseActivity.this, 1, 123);
 GroupedResultsForResultActivityResultLoader.GroupedResultsForResultActivityResult result4 = GroupedResultsForResultActivityResultLoader.load(data);
 GroupedResultsForResultActivityResultLoader.GroupedResultsForResultActivityFirstGroupResult result5 = GroupedResultsForResultActivityResultLoader.loadFirstGroup(data);
 GroupedResultsForResultActivityResultLoader.GroupedResultsForResultActivitySecondGroupResult result7 = GroupedResultsForResultActivityResultLoader.loadSecondGroup(data);

Create Activity that could be run for result or not.

@Navigable
public class ActivityWithResultOption extends BaseActivity {
    @Param(group = "firstGroup", forResult = true)
    String stringParam;
    @Param(group = "firstGroup", forResult = true)
    Boolean booleanParam;
    @Param(group = "secondGroup")
    Double doubleParam;
    @Param(group = "secondGroup")
    Integer integerParam;


    @Result(group = "firstResultGroup")
    String stringResult = "abcdefghijk";
    @Result(group = "firstResultGroup")
    Book bookResult;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        bookResult = new Book();
        bookResult.setAuthor(ForResultActivity.class.getSimpleName());
        bookResult.setPublishTime(2012);
        bookResult.setBookName("Result");

        StringBuilder stringBuilder = new StringBuilder();
        stringBuilder.append(this.getClass().getCanonicalName());
        stringBuilder.append("\n");
        stringBuilder.append(toString());
        classInfo.setText(stringBuilder);


    }

    @Override
    protected View.OnClickListener getOnCloseClickListener() {
        return new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Intent intent = ActivityWithResultOptionResultFiller.fillResultfirstResultGroup(ActivityWithResultOption.this);
                setResult(RESULT_OK, intent);
                finish();
            }
        };
    }
Navigator.activityWithResultOptionFirstGroupForResult(BaseActivity.this, "abcdefgh", true, WITH_RESULT_OPTION_ACTIVITY);
ActivityWithResultOptionResultLoader.ActivityWithResultOptionFirstResultGroupResult result8 = ActivityWithResultOptionResultLoader.loadFirstResultGroup(data);
Navigator.activityWithResultOptionSecondGroup(BaseActivity.this, 123.53, 25);

Create group of activities

@Navigable(group = "subgroup")
public class GroupedActivity extends Activity
Navigator.subgroup.groupedActivity(BaseActivity.this);

Create custom method and support classes name for Activity

@Navigable(name = "customNameWithParams")
public class NamedParamsAndResultActivity extends BaseActivity {

    @Param(forResult = true)
    Integer integerParam;
    @Param(forResult = true)
    String stringParam;
    @Param(group = "OtherGroup")
    Book parcelableParam;

    @Result
    String stringResult = "result";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        CustomNameWithParamsParamLoader.load(this);
    }

    @Override
    protected View.OnClickListener getOnCloseClickListener() {
        return new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Intent intent = CustomNameWithParamsResultFiller.fillResult(NamedParamsAndResultActivity.this);
                setResult(RESULT_OK, intent);
                finish();
            }
        };
    }
}
Navigator.customNameWithParams(BaseActivity.this, 21, "some_string", NAMED_WITH_RESULT);
Navigator.customNameWithParams(BaseActivity.this, book);
 CustomNameWithParamsResultLoader.CustomNameWithParamsResult result2 = CustomNameWithParamsResultLoader.load(data);