NetworkEvents


Source link: https://github.com/pwittchen/NetworkEvents

NetworkEvents

Android library listening network connection state and change of the WiFi signal strength with event bus.

It works with any implementation of the Event Bus. In this repository you can find samples with Otto and GreenRobot's bus.

min sdk version = 9

JavaDoc is available at: http://pwittchen.github.io/NetworkEvents

This project is deprecated!

This library is now deprecated and no longer maintained in favor of the following libraries, which do the same job, but in the better way:

Contents

Overview

Library is able to detect ConnectivityStatus when it changes.

public enum ConnectivityStatus {

UNKNOWN("unknown"),
WIFI_CONNECTED("connected to WiFi"),
WIFI_CONNECTED_HAS_INTERNET("connected to WiFi (Internet available)"),
WIFI_CONNECTED_HAS_NO_INTERNET("connected to WiFi (Internet not available)"),
MOBILE_CONNECTED("connected to mobile network"),
OFFLINE("offline");

... 
}

 

In addition, it is able to detect situation when strength of the Wifi signal was changed with WifiSignalStrengthChanged event, when we enable WiFi scanning.

Library is able to detect MobileNetworkType when ConnectivityStatus changes to MOBILE_CONNECTED.

public enum MobileNetworkType {

UNKNOWN("unknown"),
LTE("LTE"),
HSPAP("HSPAP"),
EDGE("EDGE"),
GPRS("GPRS");

... 
}

 

Usage

Appropriate permissions are already set in AndroidManifest.xml file for the library inside the <manifest> tag. They don't need to be set inside the specific application, which uses library.

Initialize objects

In your activity add BusWrapper field, which wraps your Event Bus. You can use Otto as in this sample and then create NetworkEvents field.

private BusWrapper busWrapper; private NetworkEvents networkEvents;

Create implementation of BusWrapper. You can use any event bus here. E.g. GreenRobot's Event Bus. In this example, we are wrapping Otto Event bus.

private BusWrapper getOttoBusWrapper(final Bus bus) {

return new BusWrapper() {

  @Override public void register(Object object) {

 bus.register(object);

  
}

@Override public void unregister(Object object) {

 bus.unregister(object);

  
}

@Override public void post(Object event) {

 bus.post(event);

  
}

}
; 
}

Initialize objects in onCreate(Bundle savedInstanceState) method.

@Override protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

busWrapper = getOttoBusWrapper(new Bus());

networkEvents = new NetworkEvents(context, busWrapper);
 
}

Please note: Due to memory leak in WifiManager reported in issue 43945 in Android issue tracker it's recommended to use Application Context instead of Activity Context.

NetworkEvents Customization

Custom logger

By default library logs messages about changed connectivity or WiFi signal strength to LogCat. We can create custom logger implementation in the following way:

networkEvents = new NetworkEvents(context, busWrapper, new Logger() {

@Override public void log(String message) {

  // log your message here

}
 
}
);

If we don't want to log anything, we can simply create empty implementation of the Logger interface, when log(message) method doesn't do anything.

enabling WiFi scan

WiFi Access Points scanning is disabled by default. If Wifi Access Points Scan is not enabled, WifiSignalStrengthChanged event will never occur. You can enable it as follows:

networkEvents = new NetworkEvents(context, busWrapper)
.enableWifiScan();
enabling Internet connection check

Internet connection check is disabled by default. If Internet check is disabled, status WIFI_CONNECTED_HAS_INTERNET and WIFI_CONNECTED_HAS_NO_INTERNET won't be set. If internet check is enabled WIFI_CONNECTED status will never occur (from version 2.1.0). The only statuses, which may occur after connecting to WiFi after enabling this option are WIFI_CONNECTED_HAS_INTERNET and WIFI_CONNECTED_HAS_NO_INTERNET.

You can enable internet check as follows:

networkEvents = new NetworkEvents(context, busWrapper)
.enableInternetCheck();
customizing ping parameters

You can customize ping parameters used to check Internet connectivity. You can set your own host, port and ping timeout in milliseconds as follows:

networkEvents = new NetworkEvents(context, busWrapper)
.setPingParameters("www.anyhostyouwant.com", 80, 30)

In the example presented above, library will ping www.anyhostyouwant.com on port 80 with timeout equal to 30 milliseconds.

Register and unregister objects

We have to register and unregister objects in Activity Lifecycle.

In case of different Event Buses, we have to do it differently.

Otto Bus

Register BusWrapper and NetworkEvents in onResume() method and unregister them in onPause() method.

@Override protected void onResume() {

super.onResume();

busWrapper.register(this);

networkEvents.register();
 
}
  @Override protected void onPause() {

super.onPause();

busWrapper.unregister(this);

networkEvents.unregister();
 
}

GreenRobot's Bus

Register BusWrapper and NetworkEvents in onStart() method and unregister them in onStop() method.

@Override protected void onStart() {

super.onStart();

busWrapper.register(this);

networkEvents.register();
 
}
  @Override protected void onStop() {

busWrapper.unregister(this);

networkEvents.unregister();

super.onStop();
 
}

Subscribe for the events

For Otto Event Bus @Subscribe annotations are required, but we don't have to use them in case of using library with GreenRobot's Event Bus.

@Subscribe public void onEvent(ConnectivityChanged event) {

// get connectivity status from event.getConnectivityStatus()
// or mobile network type via event.getMobileNetworkType()
// and do whatever you want 
}
  @Subscribe public void onEvent(WifiSignalStrengthChanged event) {

// do whatever you want - e.g. read fresh list of access points
// via event.getWifiScanResults() method 
}

NetworkHelper

Library has additional class called NetworkHelper with static method, which can be used for determining if device is connected to WiFi or mobile network:

NetworkHelper.isConnectedToWiFiOrMobileNetwork(context)

It returns true if device is connected to one of mentioned networks and false if not.

Examples

  • Look at MainActivity in application located in example directory to see how this library works with Otto Event Bus.
  • Example presenting how to use this library with GreenRobot's Event Bus is presented in example-greenrobot-bus directory

Download

You can depend on the library through Maven:

<dependency>
<groupId>com.github.pwittchen</groupId>
<artifactId>networkevents</artifactId>
<version>2.1.6</version> </dependency>

or through Gradle:

dependencies {

compile 'com.github.pwittchen:networkevents:2.1.6' 
}

Remember to add dependency to the Event Bus, which you are using.

In case of Otto, add the following dependency through Maven:

<dependency>
<groupId>com.squareup</groupId>
<artifactId>otto</artifactId>
<version>1.3.8</version> </dependency>

or through Gradle:

dependencies {

compile 'com.squareup:otto:1.3.8' 
}

You can also use GreenRobot's Event Bus or any Event Bus you want.

Tests

Tests are available in network-events-library/src/androidTest/java/ directory and can be executed on emulator or Android device from Android Studio or CLI with the following command:

./gradlew connectedCheck 

Test coverage report can be generated with the following command:

./gradlew createDebugCoverageReport 

In order to generate report, emulator or Android device needs to be connected to the computer. Report will be generated in the network-events-library/build/outputs/reports/coverage/debug/ directory.

Code style

Code style used in the project is called SquareAndroid from Java Code Styles repository by Square available at: https://github.com/square/java-code-styles.

Who is using this library?

Are you using this library in your app and want to be listed here? Send me a Pull Request or an e-mail to [email protected]

License

Copyright 2015 Piotr Wittchen  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. 

Resources

A tiny library that assists in saving and restoring objects to and from disk using RxJava on Android.

Android 9-patch shadow generator.

A rating toggle for Android which switches between 3 rating levels:

  • positive
  • neutral
  • negative

This library is an extension for android buttons. You can add switchable buttons with cool animations when you press on them.

Neat 2D and 3D load indicators/spinners to use in your app. The library converts pre-made spritesheets to an AnimationDrawable to returns a Loader object than extends from ImageView. A very simple idea that can liven up your app.

Android Developer Icons is a custom icon set, included are:

  • 250 hand-crafted, pixel-perfect icons in 5 sizes and 14 colors
  • an icon font, made from the set
  • all sources: .svg, .ai, .eps, .eot, .ttf, .woff

Topics


2D Engines   3D Engines   9-Patch   Action Bars   Activities   ADB   Advertisements   Analytics   Animations   ANR   AOP   API   APK   APT   Architecture   Audio   Autocomplete   Background Processing   Backward Compatibility   Badges   Bar Codes   Benchmarking   Bitmaps   Bluetooth   Blur Effects   Bread Crumbs   BRMS   Browser Extensions   Build Systems   Bundles   Buttons   Caching   Camera   Canvas   Cards   Carousels   Changelog   Checkboxes   Cloud Storages   Color Analysis   Color Pickers   Colors   Comet/Push   Compass Sensors   Conferences   Content Providers   Continuous Integration   Crash Reports   Credit Cards   Credits   CSV   Curl/Flip   Data Binding   Data Generators   Data Structures   Database   Database Browsers   Date &   Debugging   Decompilers   Deep Links   Dependency Injections   Design   Design Patterns   Dex   Dialogs   Distributed Computing   Distribution Platforms   Download Managers   Drawables   Emoji   Emulators   EPUB   Equalizers &   Event Buses   Exception Handling   Face Recognition   Feedback &   File System   File/Directory   Fingerprint   Floating Action   Fonts   Forms   Fragments   FRP   FSM   Functional Programming   Gamepads   Games   Geocaching   Gestures   GIF   Glow Pad   Gradle Plugins   Graphics   Grid Views   Highlighting   HTML   HTTP Mocking   Icons   IDE   IDE Plugins   Image Croppers   Image Loaders   Image Pickers   Image Processing   Image Views   Instrumentation   Intents   Job Schedulers   JSON   Keyboard   Kotlin   Layouts   Library Demos   List View   List Views   Localization   Location   Lock Patterns   Logcat   Logging   Mails   Maps   Markdown   Mathematics   Maven Plugins   MBaaS   Media   Menus   Messaging   MIME   Mobile Web   Native Image   Navigation   NDK   Networking   NFC   NoSQL   Number Pickers   OAuth   Object Mocking   OCR Engines   OpenGL   ORM   Other Pickers   Parallax List   Parcelables   Particle Systems   Password Inputs   PDF   Permissions   Physics Engines   Platforms   Plugin Frameworks   Preferences   Progress Indicators   ProGuard   Properties   Protocol Buffer   Pull To   Purchases   Push/Pull   QR Codes   Quick Return   Radio Buttons   Range Bars   Ratings   Recycler Views   Resources   REST   Ripple Effects   RSS   Screenshots   Scripting   Scroll Views   SDK   Search Inputs   Security   Sensors   Services   Showcase Views   Signatures   Sliding Panels   Snackbars   SOAP   Social Networks   Spannable   Spinners   Splash Screens   SSH   Static Analysis   Status Bars   Styling   SVG   System   Tags   Task Managers   TDD &   Template Engines   Testing   Testing Tools   Text Formatting   Text Views   Text Watchers   Text-to   Toasts   Toolkits For   Tools   Tooltips   Trainings   TV   Twitter   Updaters   USB   User Stories   Utils   Validation   Video   View Adapters   View Pagers   Views   Watch Face   Wearable Data   Wearables   Weather   Web Tools   Web Views   WebRTC   WebSockets   Wheel Widgets   Wi-Fi   Widgets   Windows   Wizards   XML   XMPP   YAML   ZIP Codes