Skip to content

jd-alexander/flender

Repository files navigation

Flender Maven Central Build Status Android Arsenal

Annotation triggered connectivity checking for Android - powered by Java's Aspect Oriented Programming Framework, AspectJ

Aren't you tired of doing this all over your code?

if(connectivityUtil.isConnected(context))
{
    //do something
}
else
{
   Toast.makeText(context, "Internet unavailable", LENGTH_SHORT).show();
}

With Flender connectivity checking couldn't be easier. Just annoate your method with @InternetRequired and Flender does the rest. A toast will be shown if there's no internet available and the method won't execute.

@InternetRequired
public void doSomething()
{
    Log.v("Flender", "this plugin rocks");
}

Download

buildscript {
  repositories {
    mavenCentral()
  }

  dependencies {
    classpath 'com.github.jd-alexander:flender-plugin:1.0'
  }
}

apply plugin: 'com.android.application'
apply plugin: 'flender'

Usage

For connectivity checking to work Flender needs access to the current context so set it like this : Flender.init(this); preferably in your application class or base activity. Once that's done, annotate away!.

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Flender.init(this);
        test();
    }

    @InternetRequired
    public void test()
    {
        Log.v("Flender","Only logs if internet is available");
    }
}

You can also check for WiFi and Mobile connectivity with these annotations

@WiFiRequired

@MobileRequired

If for some reason you don't want toast to be shown eg. using Flender in a service class then simply pass silent as a parameter to the respective annotation

@WiFiRequired("Silent")

@InternetRequired("Silent")

If you want to trigger custom actions based on the annotation being used you can use one of the listeners associated each annotation.

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Flender.init(this);
        Flender.setInternetUnavailable(new InternetUnavailable() {
            @Override
            public void flenderEvent() {
                materialDialog.show();
            }
        });
        test();
    }

    @InternetRequired
    public void test()
    {
    }

Once these listeners are used toasts,won't be triggered.

Contribution

Please fork repository and contribute using pull requests.

Any contributions, large or small, major features, bug fixes, additional language translations, unit/integration tests are welcomed and appreciated but will be thoroughly reviewed and discussed.

License

Copyright 2016 Joel Dean

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

About

Annotation triggered connectivity checking for Android

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published