com.atakmap.android.util

Class AttachmentManager

java.lang.Object

com.atakmap.android.util.AttachmentManager

public class AttachmentManager
extends java.lang.Object

Used for tracking number of attachments on a given map item Also contains several convenience methods for item attachments

Field Summary

Fields

Modifier and Type	Field and Description
protected MapItem	mapItem
static java.lang.String	TAG

Constructor Summary

Constructors

Constructor and Description
AttachmentManager(MapView mapView, android.widget.ImageButton attachmentsButton) Given a map item and an attachment button, track the number of attachments.

Method Summary

Modifier and Type	Method and Description
static java.io.File	addAttachment(MapItem mi, java.io.File f) Convenience method for adding an attachment to to a map item.
void	cleanup()
static java.util.List<MapItem>	findAttachmentItems()
static java.util.List<MapItem>	findAttachmentItems(MapGroup rootGroup) Find all items with attachments
static java.util.List<java.io.File>	getAttachments(java.lang.String uid) Get list of files attached to a given map item
static java.lang.String	getFolderPath(java.lang.String uid) Method for getting the folder path related to attachments.
static java.lang.String	getFolderPath(java.lang.String uid, boolean createDir) Method for getting the folder path related to attachments.
static int	getNumberOfAttachments(java.lang.String uid) Get the number of files attached to a given map item
void	hideAttachmentOption(boolean hide)
void	promptSendAttachments(MapItem item, java.lang.String onReceiveAction) Prompt the user with the option to include marker attachments
void	refresh()
void	send()
void	send(java.lang.String onReceiveAction)
protected void	sendCoT(MapItem item)
static void	sendWithAttachmentsNoPrompt(MapItem mi, java.lang.String onReceiveAction) Convenience method for sending a marker with all attachments unconditionally.
void	setMapItem(MapItem mi)
protected void	updateAttachmentsButton()
static void	viewItem(MapView mapView, MapItem mapItem, java.io.File file) View a given item attachment

Methods inherited from class java.lang.Object

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

Field Detail

TAG

public static final java.lang.String TAG

See Also:

Constant Field Values

mapItem

protected MapItem mapItem

Constructor Detail

AttachmentManager

public AttachmentManager(MapView mapView,
                         android.widget.ImageButton attachmentsButton)

Given a map item and an attachment button, track the number of attachments.

Method Detail

setMapItem

public void setMapItem(MapItem mi)

refresh

public void refresh()

cleanup

public void cleanup()

hideAttachmentOption

public void hideAttachmentOption(boolean hide)

updateAttachmentsButton

protected void updateAttachmentsButton()

send

public void send()

send

public void send(java.lang.String onReceiveAction)

sendCoT

protected void sendCoT(MapItem item)

promptSendAttachments

public void promptSendAttachments(MapItem item,
                                  java.lang.String onReceiveAction)

Prompt the user with the option to include marker attachments

Parameters:

item - Item to send

onReceiveAction - Optional receive callback

findAttachmentItems

public static java.util.List<MapItem> findAttachmentItems(MapGroup rootGroup)

Find all items with attachments

Parameters:

rootGroup - The root map group to use for scanning UIDs

Returns:

List of map items with attachments

findAttachmentItems

public static java.util.List<MapItem> findAttachmentItems()

getAttachments

public static java.util.List<java.io.File> getAttachments(java.lang.String uid)

Get list of files attached to a given map item

Parameters:

uid - Map item UID

Returns:

List of file attachments

getNumberOfAttachments

public static int getNumberOfAttachments(java.lang.String uid)

Get the number of files attached to a given map item

Parameters:

uid - Map item UID

Returns:

Number of file attachments

addAttachment

public static java.io.File addAttachment(MapItem mi,
                                         java.io.File f)

Convenience method for adding an attachment to to a map item. The attachment is going to be copied into the attachment folder. No effort is made to remove the attachment from the original location.

Parameters:

mi - the map item to attach a file to.

f - the attachment to attach to the map item.

Returns:

File the file was attached correctly.

getFolderPath

public static java.lang.String getFolderPath(java.lang.String uid,
                                             boolean createDir)

Method for getting the folder path related to attachments. The return value will be the folder that contains all attachments for a marker.

Parameters:

uid - the map item uid used to generate the folder path.

createDir - automatically create the directory if it does not exist.

Returns:

a string that is the folder path.

getFolderPath

public static java.lang.String getFolderPath(java.lang.String uid)

Method for getting the folder path related to attachments. The return value will be the folder that contains all attachments for a marker. If the folder does not exist it will be created

Parameters:

uid - the map item uid used to generate the folder path.

Returns:

a string that is the folder path.

sendWithAttachmentsNoPrompt

public static void sendWithAttachmentsNoPrompt(MapItem mi,
                                               java.lang.String onReceiveAction)

Convenience method for sending a marker with all attachments unconditionally.

Parameters:

mi - the map item.

onReceiveAction - intent that is fired when the item is sent. Listen for this if you want to be notified that it has been sent.

viewItem

public static void viewItem(MapView mapView,
                            MapItem mapItem,
                            java.io.File file)

View a given item attachment

Parameters:

mapView - Map view instance

mapItem - Attachment map item

file - Attachment file