universum.studios.android.intent

Class WebIntent

java.lang.Object

universum.studios.android.intent.BaseIntent<WebIntent>

universum.studios.android.intent.WebIntent

public class WebIntent
extends BaseIntent<WebIntent>

A BaseIntent builder implementation providing API for building and starting of intents targeting a web content related applications.

This intent builder requires only a web Url to be specified via url(String).

Valid Url for the web intent must comply with Patterns.WEB_URL matcher.

Author:

Martin Albedinsky

Field Summary

Fields

Modifier and Type	Field and Description
static Matcher	WEB_URL_MATCHER Matcher for the valid web URL.

Constructor Summary

Constructors

Constructor and Description
WebIntent()

Method Summary

Modifier and Type	Method and Description
protected void	ensureCanBuildOrThrow() Called to ensure that this builder can build its Intent from its current data.
protected android.content.Intent	onBuild(android.content.Context context) Invoked from BaseIntent.build(Context) after BaseIntent.ensureCanBuildOrThrow() to build intent specific for this intent builder from the current data.
String	url() Returns the web URL to be loaded into web browser.
WebIntent	url(String url) Sets an URL that should be loaded into framework's web browser.

Methods inherited from class universum.studios.android.intent.BaseIntent

activityNotFoundMessage, activityNotFoundMessage, build, cannotBuildIntentException, dialogTitle, dialogTitle, enterTransition, enterTransition, exitTransition, exitTransition, isActivityForIntentAvailable, notifyActivityNotFound, onStartWith, startWith, transitions

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

WEB_URL_MATCHER

public static final Matcher WEB_URL_MATCHER

Matcher for the valid web URL.

See Also:

Patterns.WEB_URL

Constructor Detail

WebIntent

public WebIntent()

Method Detail

url

public WebIntent url(@NonNull
                     String url)

Sets an URL that should be loaded into framework's web browser. Note, that the specified url must be valid web URL otherwise will be not accepted.

If the given url is valid, but doesn't contain HTTP or HTTPS prefix, then the HTTP (http://) prefix will be attached to it.

Parameters:

url - The desired URL to load into web browser.

Returns:

This intent builder to allow methods chaining.

See Also:

url()

url

@NonNull
public String url()

Returns the web URL to be loaded into web browser.

Returns:

Valid URL or empty string if not specified yet.

See Also:

url(String)

ensureCanBuildOrThrow

protected void ensureCanBuildOrThrow()

Description copied from class: BaseIntent

Called to ensure that this builder can build its Intent from its current data.

If there are some required data missing/not specified, an exception indicating such state should be thrown. The default exception may be created via BaseIntent.cannotBuildIntentException(String).

Overrides:

ensureCanBuildOrThrow in class BaseIntent<WebIntent>

onBuild

@NonNull
protected android.content.Intent onBuild(@NonNull
                                                  android.content.Context context)

Description copied from class: BaseIntent

Invoked from BaseIntent.build(Context) after BaseIntent.ensureCanBuildOrThrow() to build intent specific for this intent builder from the current data.

Specified by:

onBuild in class BaseIntent<WebIntent>

Parameters:

context - Context obtained from the IntentStarter.

Returns:

Intent instance with current data.