Export.java

package cgeo.geocaching.export;

import cgeo.geocaching.models.Geocache;

import android.support.annotation.NonNull;
import android.support.annotation.Nullable;

import android.app.Activity;

import java.util.List;

/**
 * Represents an exporter to export a {@link List} of {@link Geocache} to various formats.
 */
interface Export {
    /**
     * Export a {@link List} of {@link Geocache} to various formats.
     *
     * @param caches
     *            The {@link List} of {@link Geocache} to be exported
     * @param activity
     *            optional: Some exporters might have an UI which requires an {@link Activity}
     */
    void export(@NonNull List<Geocache> caches, @Nullable Activity activity);

    /**
     * Get the localized name of this exporter.
     *
     * @return localized name
     */
    String getName();
}