src/de/ub0r/android/andGMXsms/ConnectorSpecs.java

   1 /*
   2  * Copyright (C) 2010 Felix Bechstein
   3  *
   4  * This file is part of AndGMXsms.
   5  *
   6  * This program is free software; you can redistribute it and/or modify it under
   7  * the terms of the GNU General Public License as published by the Free Software
   8  * Foundation; either version 3 of the License, or (at your option) any later
   9  * version.
  10  *
  11  * This program is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  13  * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
  14  * details.
  15  *
  16  * You should have received a copy of the GNU General Public License along with
  17  * this program; If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 package de.ub0r.android.andGMXsms;
  21
  22 import android.content.Context;
  23 import android.content.Intent;
  24
  25 /**
  26  * ConnectorSpecs presents all necessary informations to use a connector.
  27  *
  28  * @author flx
  29  */
  30 public interface ConnectorSpecs {
  31
  32         /** Prefs: enable connector. */
  33         String PREFS_ENABLED = "enable_";
  34
  35         /** Feature: none. */
  36         short FEATURE_NONE = 0;
  37         /** Feature: multiple recipients. */
  38         short FEATURE_MULTIRECIPIENTS = 1;
  39         /** Feature: flash sms. */
  40         short FEATURE_FLASHSMS = 2;
  41         /** Feature: send later. */
  42         short FEATURE_SENDLATER = 4;
  43         /** Feature: custom sender. */
  44         short FEATURE_CUSTOMSENDER = 8;
  45
  46         /**
  47          * Init ConnectorSpecs' context.
  48          *
  49          * @param c
  50          *            context
  51          */
  52         void init(final Context c);
  53
  54         /**
  55          * Get a fresh Connector.
  56          *
  57          * @param c
  58          *            context
  59          * @return Connector
  60          */
  61         Connector getConnector(final Context c);
  62
  63         /**
  64          * @return true if connector is enabled
  65          */
  66         boolean isEnabled();
  67
  68         /**
  69          * Set Account's balance.
  70          *
  71          * @param b
  72          *            balance
  73          */
  74         void setBalance(final String b);
  75
  76         /**
  77          * Get Conector's account balance. This does not run any update!
  78          *
  79          * @return balance
  80          */
  81         String getBalance();
  82
  83         /**
  84          * @return connector's author
  85          */
  86         String getAuthor();
  87
  88         /**
  89          * @return prefix for preferences
  90          */
  91         String getPrefsPrefix();
  92
  93         /**
  94          * @return connector's preference intent
  95          */
  96         Intent getPreferencesIntent();
  97
  98         /**
  99          * @return connector's preference title
 100          */
 101         String getPreferencesTitle();
 102
 103         /**
 104          * @param shortName
 105          *            get short name?
 106          * @return conector's name
 107          */
 108         String getName(final boolean shortName);
 109
 110         /**
 111          * @return supported feature
 112          */
 113         short getFeatures();
 114 }