net.gini.android.vision.review

Class ReviewFragmentStandard

java.lang.Object

Fragment

net.gini.android.vision.review.ReviewFragmentStandard

All Implemented Interfaces:

ReviewFragmentInterface

public class ReviewFragmentStandard
extends Fragment
implements ReviewFragmentInterface

Component API

When you use the Compontent API without the Android Support Library, the ReviewFragmentStandard displays the photographed or imported image and allows the user to review it by checking the sharpness, quality and orientation of the image. The user can correct the orientation by rotating the image.

Include the ReviewFragmentStandard into your layout by using the ReviewFragmentStandard.createInstance(Document) factory method to create an instance and display it using the android.app.FragmentManager.

A ReviewFragmentListener instance must be available until the ReviewFragmentStandard is attached to an activity. Failing to do so will throw an exception. The listener instance can be provided either implicitly by making the hosting Activity implement the ReviewFragmentListener interface or explicitly by setting the listener using ReviewFragmentStandard.setListener(ReviewFragmentListener).

Your Activity is automatically set as the listener in ReviewFragmentStandard.onCreate(Bundle).

Customizing the Review Screen

See the ReviewActivity for details.

Constructor Summary

Constructors

Constructor and Description
ReviewFragmentStandard()

Method Summary

Modifier and Type	Method and Description
static ReviewFragmentStandard	createInstance(Document document) Factory method for creating a new instance of the Fragment using the provided document.
void	onDocumentAnalyzed() You should call this method after you've received the analysis results from the Gini API.
void	onNoExtractionsFound() You should call this method after you've received the analysis results from the Gini API without the required extractions.
void	onSaveInstanceState(Bundle outState)
void	setListener(ReviewFragmentListener listener) Set a listener for review events.
void	showAlertDialog(java.lang.String message, java.lang.String positiveButtonTitle, DialogInterface.OnClickListener positiveButtonClickListener, java.lang.String negativeButtonTitle, DialogInterface.OnClickListener negativeButtonClickListener, DialogInterface.OnCancelListener cancelListener)

Methods inherited from class java.lang.Object

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

Constructor Detail

ReviewFragmentStandard

public ReviewFragmentStandard()

Method Detail

createInstance

public static ReviewFragmentStandard createInstance(Document document)

Factory method for creating a new instance of the Fragment using the provided document.

Note: Always use this method to create new instances. Document is required and an exception is thrown if it's missing.

Parameters:

document - must be the Document from CameraFragmentListener.onDocumentAvailable(Document)

Returns:

a new instance of the Fragment

onSaveInstanceState

public void onSaveInstanceState(Bundle outState)

onDocumentAnalyzed

public void onDocumentAnalyzed()

Description copied from interface: ReviewFragmentInterface

You should call this method after you've received the analysis results from the Gini API.

This is important for managing the behavior of the Review Document Fragment when the Next button was clicked.

If the document has already been analyzed and the image wasn't changed when the user tapped the Next button, ReviewFragmentListener.onDocumentReviewedAndAnalyzed(Document) is called and there is no need to show an AnalysisActivity or AnalysisFragmentStandard or AnalysisFragmentCompat.

If the document wasn't analyzed or the image was changed when the user tapped the Next button, ReviewFragmentListener.onProceedToAnalysisScreen(Document) is called.

Specified by:

onDocumentAnalyzed in interface ReviewFragmentInterface

onNoExtractionsFound

public void onNoExtractionsFound()

Description copied from interface: ReviewFragmentInterface

You should call this method after you've received the analysis results from the Gini API without the required extractions.

Specified by:

onNoExtractionsFound in interface ReviewFragmentInterface

setListener

public void setListener(ReviewFragmentListener listener)

Description copied from interface: ReviewFragmentInterface

Set a listener for review events.

By default the hosting Activity is expected to implement the ReviewFragmentListener. In case that is not feasible you may set the listener using this method.

Note: the listener is expected to be available until the fragment is attached to an activity. Make sure to set the listener before that.

Specified by:

setListener in interface ReviewFragmentInterface

Parameters:

listener - ReviewFragmentListener instance

showAlertDialog

public void showAlertDialog(java.lang.String message,
                            java.lang.String positiveButtonTitle,
                            DialogInterface.OnClickListener positiveButtonClickListener,
                            java.lang.String negativeButtonTitle,
                            DialogInterface.OnClickListener negativeButtonClickListener,
                            DialogInterface.OnCancelListener cancelListener)