org.corfudb.runtime.view

Class AbstractView

java.lang.Object

org.corfudb.runtime.view.AbstractView

Direct Known Subclasses:

AddressSpaceView, LayoutManagementView, LayoutView, ManagementView, ObjectsView, SequencerView, StreamsView

public abstract class AbstractView
extends Object

All views inherit from AbstractView.

AbstractView requires a runtime, and provides a layoutHelper function.

The layoutHelper function is called whenever a view tries to access a layout. If the layoutHelper catches an exception which is due to connection issues or an incorrect epoch, it asks the runtime to invalidate that layout by reporting it to a layout server, and retries the function.

Created by mwei on 12/10/15.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	AbstractView.LayoutFunction<V,R,A extends Throwable,B extends Throwable,C extends Throwable,D extends Throwable>

Constructor Summary

Constructors

Constructor and Description
AbstractView(CorfuRuntime runtime)

Method Summary

Modifier and Type	Method and Description
Layout	getCurrentLayout() Get the current layout.
<T,A extends RuntimeException,B extends RuntimeException,C extends RuntimeException,D extends RuntimeException> T	layoutHelper(AbstractView.LayoutFunction<Layout,T,A,B,C,D> function)
<T,A extends RuntimeException,B extends RuntimeException,C extends RuntimeException,D extends RuntimeException> T	layoutHelper(AbstractView.LayoutFunction<Layout,T,A,B,C,D> function, boolean rethrowAllExceptions) Helper function for view to retrieve layouts.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractView

public AbstractView(@Nonnull
                    CorfuRuntime runtime)

Method Detail

getCurrentLayout

public Layout getCurrentLayout()

Get the current layout.

Returns:

The current layout.

layoutHelper

public <T,A extends RuntimeException,B extends RuntimeException,C extends RuntimeException,D extends RuntimeException> T layoutHelper(AbstractView.LayoutFunction<Layout,T,A,B,C,D> function)
                                                                                                                               throws A extends RuntimeException,
                                                                                                                                      B extends RuntimeException,
                                                                                                                                      C extends RuntimeException,
                                                                                                                                      D extends RuntimeException

Throws:

A extends RuntimeException

layoutHelper

public <T,A extends RuntimeException,B extends RuntimeException,C extends RuntimeException,D extends RuntimeException> T layoutHelper(AbstractView.LayoutFunction<Layout,T,A,B,C,D> function,
                                                                                                                                      boolean rethrowAllExceptions)
                                                                                                                               throws A extends RuntimeException,
                                                                                                                                      B extends RuntimeException,
                                                                                                                                      C extends RuntimeException,
                                                                                                                                      D extends RuntimeException

Helper function for view to retrieve layouts. This function will retry the given function indefinitely, invalidating the view if there was a exception contacting the endpoint. There is a flag to set if we want the caller to handle Runtime Exceptions. For some special cases (like writes), we need to do a bit more work upon a Runtime Exception than just retry.

Type Parameters:

T - The return type of the function.

A - Any exception the function may throw.

B - Any exception the function may throw.

C - Any exception the function may throw.

D - Any exception the function may throw.

Parameters:

function - The function to execute.

rethrowAllExceptions - if all exceptions are rethrown to caller.

Returns:

The return value of the function.

Throws:

A extends RuntimeException