diff --git a/doc/小米便签开源代码泛读报告.docx b/doc/小米便签开源代码泛读报告.docx new file mode 100644 index 0000000..6082b20 Binary files /dev/null and b/doc/小米便签开源代码泛读报告.docx differ diff --git a/src/notes/gtask/exception/ActionFailureException.java b/src/notes/gtask/exception/ActionFailureException.java new file mode 100644 index 0000000..b567040 --- /dev/null +++ b/src/notes/gtask/exception/ActionFailureException.java @@ -0,0 +1,41 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.gtask.exception; + +public class ActionFailureException extends RuntimeException { + private static final long serialVersionUID = 4425249765923293627L; + /* + * serialVersionUID相当于java类的身份证。主要用于版本控制,Java的序列化机制是通过在运行时判断类的serialVersionUID来验证版本一致性的。 + * serialVersionUID作用是序列化时保持版本的兼容性，即在版本升级时反序列化仍保持对象的唯一性。 + */ + public ActionFailureException() { + super(); + } + /* + * 在JAVA类中使用super来引用父类的成分，用this来引用当前对象. + * 如果一个类从另外一个类继承，我们new这个子类的实例对象的时候，这个子类对象里面会有一个父类对象。 + * 怎么去引用里面的父类对象呢？使用super来引用 + * 也就是说，此处super()以及super (paramString)可认为是Exception ()和Exception (paramString) + */ + public ActionFailureException(String paramString) { + super(paramString); + } + + public ActionFailureException(String paramString, Throwable paramThrowable) { + super(paramString, paramThrowable); + } +} diff --git a/src/notes/gtask/exception/NetworkFailureException.java b/src/notes/gtask/exception/NetworkFailureException.java new file mode 100644 index 0000000..8b3d7b7 --- /dev/null +++ b/src/notes/gtask/exception/NetworkFailureException.java @@ -0,0 +1,42 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.gtask.exception; + +public class NetworkFailureException extends Exception { + private static final long serialVersionUID = 2107610287180234136L; + /* + * serialVersionUID相当于java类的身份证。主要用于版本控制，,Java的序列化机制是通过在运行时判断类的serialVersionUID来验证版本一致性的。 + * serialVersionUID作用是序列化时保持版本的兼容性，即在版本升级时反序列化仍保持对象的唯一性。 + */ + + public NetworkFailureException() { + super(); + } + /* + * 在JAVA类中使用super来引用父类的成分，用this来引用当前对象. + * 如果一个类从另外一个类继承，我们new这个子类的实例对象的时候，这个子类对象里面会有一个父类对象。 + * 怎么去引用里面的父类对象呢？使用super来引用 + * 也就是说，此处super()以及super (paramString)可认为是Exception ()和Exception (paramString) + */ + public NetworkFailureException(String paramString) { + super(paramString); + } + + public NetworkFailureException(String paramString, Throwable paramThrowable) { + super(paramString, paramThrowable); + } +} diff --git a/src/notes/gtask/remote/GTaskASyncTask.java b/src/notes/gtask/remote/GTaskASyncTask.java new file mode 100644 index 0000000..3102b14 --- /dev/null +++ b/src/notes/gtask/remote/GTaskASyncTask.java @@ -0,0 +1,133 @@ + +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.gtask.remote; +/*异步操作类，实现GTask的异步操作过程 + * 主要方法： + * private void showNotification(int tickerId, String content) 向用户提示当前同步的状态，是一个用于交互的方法 + * protected Integer doInBackground(Void... unused) 此方法在后台线程执行，完成任务的主要工作，通常需要较长的时间 + * protected void onProgressUpdate(String... progress) 可以使用进度条增加用户体验度。 此方法在主线程执行，用于显示任务执行的进度。 + * protected void onPostExecute(Integer result) 相当于Handler 处理UI的方式，在这里面可以使用在doInBackground 得到的结果处理操作UI + */ +import android.app.Notification; +import android.app.NotificationManager; +import android.app.PendingIntent; +import android.content.Context; +import android.content.Intent; +import android.os.AsyncTask; + +import net.micode.notes.R; +import net.micode.notes.ui.NotesListActivity; +import net.micode.notes.ui.NotesPreferenceActivity; + + +public class GTaskASyncTask extends AsyncTask { + + private static int GTASK_SYNC_NOTIFICATION_ID = 5234235; + + public interface OnCompleteListener { + void onComplete(); + } + + private Context mContext; + + private NotificationManager mNotifiManager; + + private GTaskManager mTaskManager; + + private OnCompleteListener mOnCompleteListener; + + public GTaskASyncTask(Context context, OnCompleteListener listener) { + mContext = context; + mOnCompleteListener = listener; + mNotifiManager = (NotificationManager) mContext + .getSystemService(Context.NOTIFICATION_SERVICE); + mTaskManager = GTaskManager.getInstance(); + } + + public void cancelSync() { + mTaskManager.cancelSync(); + } + + public void publishProgess(String message) {//发布进度单位，系统将会调用onProgressUpdate()方法更新这些值。 + publishProgress(new String[] { + message + }); + } + + private void showNotification(int tickerId, String content) { + PendingIntent pendingIntent;//一个描述了想要启动一个Activity、Broadcast或是Service的意图。 + if (tickerId != R.string.ticker_success) { + pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext, + NotesPreferenceActivity.class), 0);//如果同步不成功，那么从系统取得一个用于启动一个NotesPreferenceActivity的PendingIntent对象。 + + } else { + pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext, + NotesListActivity.class), 0);//如果同步成功，那么从系统取得一个用于启动一个NotesListActivity的PendingIntent对象。 + } + + + Notification.Builder builder = new Notification.Builder(mContext) + .setAutoCancel(true) + .setContentTitle(mContext.getString(R.string.app_name)) + .setContentText(content) + .setContentIntent(pendingIntent) + .setWhen(System.currentTimeMillis()) + .setOngoing(true); + Notification notification=builder.getNotification(); + mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification);//通过NotificationManager对象的notify（）方法来执行一个notification的消息。 + } + + @Override + protected Integer doInBackground(Void... unused) { + publishProgess(mContext.getString(R.string.sync_progress_login, NotesPreferenceActivity + .getSyncAccountName(mContext)));//利用getString,将把 NotesPreferenceActivity.getSyncAccountName(mContext))的字符串内容传进sync_progress_login中。 + return mTaskManager.sync(mContext, this);//进行后台同步。 + } + + @Override + protected void onProgressUpdate(String... progress) { + showNotification(R.string.ticker_syncing, progress[0]); + if (mContext instanceof GTaskSyncService) { + ((GTaskSyncService) mContext).sendBroadcast(progress[0]); + }//instanceof 判断mContext是否是GTaskSyncService的实例 + } + + @Override + protected void onPostExecute(Integer result) {//在执行完后台任务后更新UI,显示结果。 + if (result == GTaskManager.STATE_SUCCESS) { + showNotification(R.string.ticker_success, mContext.getString( + R.string.success_sync_account, mTaskManager.getSyncAccount())); + NotesPreferenceActivity.setLastSyncTime(mContext, System.currentTimeMillis());//设置最新的同步时间。 + } else if (result == GTaskManager.STATE_NETWORK_ERROR) { + showNotification(R.string.ticker_fail, mContext.getString(R.string.error_sync_network)); + } else if (result == GTaskManager.STATE_INTERNAL_ERROR) { + showNotification(R.string.ticker_fail, mContext.getString(R.string.error_sync_internal)); + } else if (result == GTaskManager.STATE_SYNC_CANCELLED) { + showNotification(R.string.ticker_cancel, mContext + .getString(R.string.error_sync_cancelled)); + }//不同情况的结果如上。 + if (mOnCompleteListener != null) { + new Thread(new Runnable() { + + public void run() { + mOnCompleteListener.onComplete(); + }//完成一次操作后，使用onComplete()将所有值都重新初始化。 + }).start(); + } + } +} diff --git a/src/notes/gtask/remote/GTaskClient.java b/src/notes/gtask/remote/GTaskClient.java new file mode 100644 index 0000000..29c5077 --- /dev/null +++ b/src/notes/gtask/remote/GTaskClient.java @@ -0,0 +1,669 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.gtask.remote; +/*GTask 客户端，提供登录 Google 账户，创建任务和任务列表，添加和删除结点，提交、重置更新，获取任务列表等功能*/ +import android.accounts.Account; +import android.accounts.AccountManager; +import android.accounts.AccountManagerFuture; +import android.app.Activity; +import android.os.Bundle; +import android.text.TextUtils; +import android.util.Log; + +import net.micode.notes.gtask.data.Node; +import net.micode.notes.gtask.data.Task; +import net.micode.notes.gtask.data.TaskList; +import net.micode.notes.gtask.exception.ActionFailureException; +import net.micode.notes.gtask.exception.NetworkFailureException; +import net.micode.notes.tool.GTaskStringUtils; +import net.micode.notes.ui.NotesPreferenceActivity; + +import org.apache.http.HttpEntity; +import org.apache.http.HttpResponse; +import org.apache.http.client.ClientProtocolException; +import org.apache.http.client.entity.UrlEncodedFormEntity; +import org.apache.http.client.methods.HttpGet; +import org.apache.http.client.methods.HttpPost; +import org.apache.http.cookie.Cookie; +import org.apache.http.impl.client.BasicCookieStore; +import org.apache.http.impl.client.DefaultHttpClient; +import org.apache.http.message.BasicNameValuePair; +import org.apache.http.params.BasicHttpParams; +import org.apache.http.params.HttpConnectionParams; +import org.apache.http.params.HttpParams; +import org.apache.http.params.HttpProtocolParams; +import org.json.JSONArray; +import org.json.JSONException; +import org.json.JSONObject; + +import java.io.BufferedReader; +import java.io.IOException; +import java.io.InputStream; +import java.io.InputStreamReader; +import java.util.LinkedList; +import java.util.List; +import java.util.zip.GZIPInputStream; +import java.util.zip.Inflater; +import java.util.zip.InflaterInputStream; + +public class GTaskClient { + private static final String TAG = GTaskClient.class.getSimpleName(); + + private static final String GTASK_URL = "https://mail.google.com/tasks/"; //这个是指定的URL + + private static final String GTASK_GET_URL = "https://mail.google.com/tasks/ig"; + + private static final String GTASK_POST_URL = "https://mail.google.com/tasks/r/ig"; + + private static GTaskClient mInstance = null; + + private DefaultHttpClient mHttpClient; + + private String mGetUrl; + + private String mPostUrl; + + private long mClientVersion; + + private boolean mLoggedin; + + private long mLastLoginTime; + + private int mActionId; + + private Account mAccount; + + private JSONArray mUpdateArray; + + private GTaskClient() { + mHttpClient = null; + mGetUrl = GTASK_GET_URL; + mPostUrl = GTASK_POST_URL; + mClientVersion = -1; + mLoggedin = false; + mLastLoginTime = 0; + mActionId = 1; + mAccount = null; + mUpdateArray = null; + } + + /*用来获取的实例化对象 + * 使用 getInstance() + * 返回mInstance这个实例化对象 + */ + public static synchronized GTaskClient getInstance() { + if (mInstance == null) { + mInstance = new GTaskClient(); + } + return mInstance; + } + + /*用来实现登录操作的函数，传入的参数是一个Activity + * 设置登录操作限制时间，如果超时则需要重新登录 + * 有两种登录方式，使用用户自己的URL登录或者使用谷歌官方的URL登录 + * 返回true或者false，即最后是否登陆成功 + */ + public boolean login(Activity activity) { + // we suppose that the cookie would expire after 5 minutes + // then we need to re-login + //判断距离最后一次登录操作是否超过5分钟 + final long interval = 1000 * 60 * 5; + if (mLastLoginTime + interval < System.currentTimeMillis()) { + mLoggedin = false; + } + + // need to re-login after account switch 重新登录操作 + if (mLoggedin + && !TextUtils.equals(getSyncAccount().name, NotesPreferenceActivity + .getSyncAccountName(activity))) { + mLoggedin = false; + } + + //如果没超过时间，则不需要重新登录 + if (mLoggedin) { + Log.d(TAG, "already logged in"); + return true; + } + + mLastLoginTime = System.currentTimeMillis();//更新最后登录时间，改为系统当前的时间 + String authToken = loginGoogleAccount(activity, false);//判断是否登录到谷歌账户 + if (authToken == null) { + Log.e(TAG, "login google account failed"); + return false; + } + + // login with custom domain if necessary + //尝试使用用户自己的域名登录 + if (!(mAccount.name.toLowerCase().endsWith("gmail.com") || mAccount.name.toLowerCase() //将用户账号名改为统一格式（小写）后判断是否为一个谷歌账号地址 + .endsWith("googlemail.com"))) { + StringBuilder url = new StringBuilder(GTASK_URL).append("a/"); + int index = mAccount.name.indexOf('@') + 1; + String suffix = mAccount.name.substring(index); + url.append(suffix + "/"); + mGetUrl = url.toString() + "ig"; //设置用户对应的getUrl + mPostUrl = url.toString() + "r/ig"; //设置用户对应的postUrl + + if (tryToLoginGtask(activity, authToken)) { + mLoggedin = true; + } + } + + // try to login with google official url + //如果用户账户无法登录，则使用谷歌官方的URI进行登录 + if (!mLoggedin) { + mGetUrl = GTASK_GET_URL; + mPostUrl = GTASK_POST_URL; + if (!tryToLoginGtask(activity, authToken)) { + return false; + } + } + + mLoggedin = true; + return true; + } + + /*具体实现登录谷歌账户的方法 + * 使用令牌机制 + * 使用AccountManager来管理注册账号 + * 返回值是账号的令牌 + */ + private String loginGoogleAccount(Activity activity, boolean invalidateToken) { + String authToken; //令牌，是登录操作保证安全性的一个方法 + AccountManager accountManager = AccountManager.get(activity);//AccountManager这个类给用户提供了集中注册账号的接口 + Account[] accounts = accountManager.getAccountsByType("com.google");//获取全部以com.google结尾的account + + if (accounts.length == 0) { + Log.e(TAG, "there is no available google account"); + return null; + } + + String accountName = NotesPreferenceActivity.getSyncAccountName(activity); + Account account = null; + //遍历获得的accounts信息，寻找已经记录过的账户信息 + for (Account a : accounts) { + if (a.name.equals(accountName)) { + account = a; + break; + } + } + if (account != null) { + mAccount = account; + } else { + Log.e(TAG, "unable to get an account with the same name in the settings"); + return null; + } + + // get the token now + //获取选中账号的令牌 + AccountManagerFuture accountManagerFuture = accountManager.getAuthToken(account, + "goanna_mobile", null, activity, null, null); + try { + Bundle authTokenBundle = accountManagerFuture.getResult(); + authToken = authTokenBundle.getString(AccountManager.KEY_AUTHTOKEN); + //如果是invalidateToken，那么需要调用invalidateAuthToken(String, String)方法废除这个无效token + if (invalidateToken) { + accountManager.invalidateAuthToken("com.google", authToken); + loginGoogleAccount(activity, false); + } + } catch (Exception e) { + Log.e(TAG, "get auth token failed"); + authToken = null; + } + + return authToken; + } + + //尝试登陆Gtask，这只是一个预先判断令牌是否是有效以及是否能登上GTask的方法,而不是具体实现登陆的方法 + private boolean tryToLoginGtask(Activity activity, String authToken) { + if (!loginGtask(authToken)) { + // maybe the auth token is out of authTokedate, now let's invalidate the + // token and try again + //删除过一个无效的authToken，申请一个新的后再次尝试登陆 + authToken = loginGoogleAccount(activity, true); + if (authToken == null) { + Log.e(TAG, "login google account failed"); + return false; + } + + if (!loginGtask(authToken)) { + Log.e(TAG, "login gtask failed"); + return false; + } + } + return true; + } + + //实现登录GTask的具体操作 + private boolean loginGtask(String authToken) { + int timeoutConnection = 10000; + int timeoutSocket = 15000; //socket是一种通信连接实现数据的交换的端口 + HttpParams httpParameters = new BasicHttpParams(); //实例化一个新的HTTP参数类 + HttpConnectionParams.setConnectionTimeout(httpParameters, timeoutConnection);//设置连接超时时间 + HttpConnectionParams.setSoTimeout(httpParameters, timeoutSocket);//设置设置端口超时时间 + mHttpClient = new DefaultHttpClient(httpParameters); + BasicCookieStore localBasicCookieStore = new BasicCookieStore(); //设置本地cookie + mHttpClient.setCookieStore(localBasicCookieStore); + HttpProtocolParams.setUseExpectContinue(mHttpClient.getParams(), false); + + // login gtask + try { + String loginUrl = mGetUrl + "?auth=" + authToken; //设置登录的url + HttpGet httpGet = new HttpGet(loginUrl); //通过登录的uri实例化网页上资源的查找 + HttpResponse response = null; + response = mHttpClient.execute(httpGet); + + // get the cookie now + //获取CookieStore里存放的cookie,看如果存有“GTL(不知道什么意思)”，则说明有验证成功的有效的cookie + List cookies = mHttpClient.getCookieStore().getCookies(); + boolean hasAuthCookie = false; + for (Cookie cookie : cookies) { + if (cookie.getName().contains("GTL")) { + hasAuthCookie = true; + } + } + if (!hasAuthCookie) { + Log.w(TAG, "it seems that there is no auth cookie"); + } + + // get the client version + //获取client的内容，具体操作是在返回的Content中截取从_setup(开始到)}中间的字符串内容，也就是gtask_url的内容 + String resString = getResponseContent(response.getEntity()); + String jsBegin = "_setup("; + String jsEnd = ")}"; + int begin = resString.indexOf(jsBegin); + int end = resString.lastIndexOf(jsEnd); + String jsString = null; + if (begin != -1 && end != -1 && begin < end) { + jsString = resString.substring(begin + jsBegin.length(), end); + } + JSONObject js = new JSONObject(jsString); + mClientVersion = js.getLong("v"); + } catch (JSONException e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + return false; + } catch (Exception e) { + // simply catch all exceptions + Log.e(TAG, "httpget gtask_url failed"); + return false; + } + + return true; + } + + private int getActionId() { + return mActionId++; + } + + /*实例化创建一个用于向网络传输数据的对象 + * 使用HttpPost类 + * 返回一个httpPost实例化对象，但里面还没有内容 + */ + private HttpPost createHttpPost() { + HttpPost httpPost = new HttpPost(mPostUrl); + httpPost.setHeader("Content-Type", "application/x-www-form-urlencoded;charset=utf-8"); + httpPost.setHeader("AT", "1"); + return httpPost; + } + + /*通过URL获取响应后返回的数据，也就是网络上的数据和资源 + * 使用getContentEncoding()获取网络上的资源和数据 + * 返回值就是获取到的资源 + */ + private String getResponseContent(HttpEntity entity) throws IOException { + String contentEncoding = null; + if (entity.getContentEncoding() != null) {//通过URL得到HttpEntity对象，如果不为空则使用getContent（）方法创建一个流将数据从网络都过来 + contentEncoding = entity.getContentEncoding().getValue(); + Log.d(TAG, "encoding: " + contentEncoding); + } + + InputStream input = entity.getContent(); + if (contentEncoding != null && contentEncoding.equalsIgnoreCase("gzip")) {//GZIP是使用DEFLATE进行压缩数据的另一个压缩库 + input = new GZIPInputStream(entity.getContent()); + } else if (contentEncoding != null && contentEncoding.equalsIgnoreCase("deflate")) {//DEFLATE是一个无专利的压缩算法，它可以实现无损数据压缩 + Inflater inflater = new Inflater(true); + input = new InflaterInputStream(entity.getContent(), inflater); + } + + try { + InputStreamReader isr = new InputStreamReader(input); + BufferedReader br = new BufferedReader(isr);//是一个包装类，它可以包装字符流，将字符流放入缓存里，先把字符读到缓存里，到缓存满了时候，再读入内存，是为了提供读的效率而设计的 + StringBuilder sb = new StringBuilder(); + + while (true) { + String buff = br.readLine(); + if (buff == null) { + return sb.toString(); + } + sb = sb.append(buff); + } + } finally { + input.close(); + } + } + + /*通过JSON发送请求 + * 请求的具体内容在json的实例化对象js中然后传入 + * 利用UrlEncodedFormEntity entity和httpPost.setEntity(entity)方法把js中的内容放置到httpPost中 + * 执行请求后使用getResponseContent方法得到返回的数据和资源 + * 将资源再次放入json后返回 + */ + private JSONObject postRequest(JSONObject js) throws NetworkFailureException { + if (!mLoggedin) {//未登录 + Log.e(TAG, "please login first"); + throw new ActionFailureException("not logged in"); + } + + //实例化一个httpPost的对象用来向服务器传输数据，在这里就是发送请求，而请求的内容在js里 + HttpPost httpPost = createHttpPost(); + try { + LinkedList list = new LinkedList(); + list.add(new BasicNameValuePair("r", js.toString())); + UrlEncodedFormEntity entity = new UrlEncodedFormEntity(list, "UTF-8"); //UrlEncodedFormEntity()的形式比较单一，是普通的键值对 + httpPost.setEntity(entity); + + // execute the post + //执行这个请求 + HttpResponse response = mHttpClient.execute(httpPost); + String jsString = getResponseContent(response.getEntity()); + return new JSONObject(jsString); + + } catch (ClientProtocolException e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + throw new NetworkFailureException("postRequest failed"); + } catch (IOException e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + throw new NetworkFailureException("postRequest failed"); + } catch (JSONException e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + throw new ActionFailureException("unable to convert response content to jsonobject"); + } catch (Exception e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + throw new ActionFailureException("error occurs when posting request"); + } + } + + /*创建单个任务 + * 传入参数是一个.gtask.data.Task包里Task类的对象 + * 利用json获取Task里的内容,并且创建相应的jsPost + * 利用postRequest得到任务的返回信息 + * 使用task.setGid设置task的new_ID + */ + public void createTask(Task task) throws NetworkFailureException { + commitUpdate(); + try { + JSONObject jsPost = new JSONObject(); + JSONArray actionList = new JSONArray(); + + // action_list + actionList.put(task.getCreateAction(getActionId())); + jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList); + + // client_version + jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion); + + // post + JSONObject jsResponse = postRequest(jsPost); + JSONObject jsResult = (JSONObject) jsResponse.getJSONArray( + GTaskStringUtils.GTASK_JSON_RESULTS).get(0); + task.setGid(jsResult.getString(GTaskStringUtils.GTASK_JSON_NEW_ID)); + + } catch (JSONException e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + throw new ActionFailureException("create task: handing jsonobject failed"); + } + } + + /* + * 创建一个任务列表，与createTask几乎一样，区别就是最后设置的是tasklist的gid + */ + public void createTaskList(TaskList tasklist) throws NetworkFailureException { + commitUpdate(); + try { + JSONObject jsPost = new JSONObject(); + JSONArray actionList = new JSONArray(); + + // action_list + actionList.put(tasklist.getCreateAction(getActionId())); + jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList); + + // client version + jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion); + + // post + JSONObject jsResponse = postRequest(jsPost); + JSONObject jsResult = (JSONObject) jsResponse.getJSONArray( + GTaskStringUtils.GTASK_JSON_RESULTS).get(0); + tasklist.setGid(jsResult.getString(GTaskStringUtils.GTASK_JSON_NEW_ID)); + + } catch (JSONException e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + throw new ActionFailureException("create tasklist: handing jsonobject failed"); + } + } + + /* + * 同步更新操作 + * 使用JSONObject进行数据存储，使用jsPost.put，Put的信息包括UpdateArray和ClientVersion + * 使用postRequest发送这个jspost,进行处理 + */ + public void commitUpdate() throws NetworkFailureException { + if (mUpdateArray != null) { + try { + JSONObject jsPost = new JSONObject(); + + // action_list + jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, mUpdateArray); + + // client_version + jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion); + + postRequest(jsPost); + mUpdateArray = null; + } catch (JSONException e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + throw new ActionFailureException("commit update: handing jsonobject failed"); + } + } + } + + /* + * 添加更新的事项 + * 调用commitUpdate()实现 + */ + public void addUpdateNode(Node node) throws NetworkFailureException { + if (node != null) { + // too many update items may result in an error + // set max to 10 items + if (mUpdateArray != null && mUpdateArray.length() > 10) { + commitUpdate(); + } + + if (mUpdateArray == null) + mUpdateArray = new JSONArray(); + mUpdateArray.put(node.getUpdateAction(getActionId())); + } + } + + /* + * 移动task,比如讲task移动到不同的task列表中去 + * 通过getGid获取task所属列表的gid + * 通过JSONObject.put(String name, Object value)函数设置移动后的task的相关属性值，从而达到移动的目的 + * 最后还是通过postRequest进行更新后的发送 + */ + public void moveTask(Task task, TaskList preParent, TaskList curParent) + throws NetworkFailureException { + commitUpdate(); + try { + JSONObject jsPost = new JSONObject(); + JSONArray actionList = new JSONArray(); + JSONObject action = new JSONObject(); + + // action_list + action.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, + GTaskStringUtils.GTASK_JSON_ACTION_TYPE_MOVE); + action.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, getActionId()); + action.put(GTaskStringUtils.GTASK_JSON_ID, task.getGid()); + if (preParent == curParent && task.getPriorSibling() != null) { + // put prioring_sibing_id only if moving within the tasklist and + // it is not the first one + //设置优先级ID，只有当移动是发生在文件中 + action.put(GTaskStringUtils.GTASK_JSON_PRIOR_SIBLING_ID, task.getPriorSibling()); + } + action.put(GTaskStringUtils.GTASK_JSON_SOURCE_LIST, preParent.getGid()); //设置移动前所属列表 + action.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT, curParent.getGid()); //设置当前所属列表 + if (preParent != curParent) { + // put the dest_list only if moving between tasklists + action.put(GTaskStringUtils.GTASK_JSON_DEST_LIST, curParent.getGid()); + } + actionList.put(action); + //最后将ACTION_LIST加入到jsPost中 + jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList); + + // client_version + jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion); + + postRequest(jsPost); + + } catch (JSONException e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + throw new ActionFailureException("move task: handing jsonobject failed"); + } + } + + /* + * 删除操作节点 + * 还是利用JSON + * 删除过后使用postRequest发送删除后的结果 + */ + public void deleteNode(Node node) throws NetworkFailureException { + commitUpdate(); + try { + JSONObject jsPost = new JSONObject(); + JSONArray actionList = new JSONArray(); + + // action_list + node.setDeleted(true); + actionList.put(node.getUpdateAction(getActionId())); //这里会获取到删除操作的ID，加入到actionLiast中 + jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList); + + // client_version + jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion); + + postRequest(jsPost); + mUpdateArray = null; + } catch (JSONException e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + throw new ActionFailureException("delete node: handing jsonobject failed"); + } + } + + /* + * 获取任务列表 + * 首先通过GetURI使用getResponseContent从网上获取数据 + * 然后筛选出"_setup("到)}的部分，并且从中获取GTASK_JSON_LISTS的内容返回 + */ + public JSONArray getTaskLists() throws NetworkFailureException { + if (!mLoggedin) { + Log.e(TAG, "please login first"); + throw new ActionFailureException("not logged in"); + } + + try { + HttpGet httpGet = new HttpGet(mGetUrl); + HttpResponse response = null; + response = mHttpClient.execute(httpGet); + + // get the task list + //筛选工作，把筛选出的字符串放入jsString + String resString = getResponseContent(response.getEntity()); + String jsBegin = "_setup("; + String jsEnd = ")}"; + int begin = resString.indexOf(jsBegin); + int end = resString.lastIndexOf(jsEnd); + String jsString = null; + if (begin != -1 && end != -1 && begin < end) { + jsString = resString.substring(begin + jsBegin.length(), end); + } + JSONObject js = new JSONObject(jsString); + //获取GTASK_JSON_LISTS + return js.getJSONObject("t").getJSONArray(GTaskStringUtils.GTASK_JSON_LISTS); + } catch (ClientProtocolException e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + throw new NetworkFailureException("gettasklists: httpget failed"); + } catch (IOException e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + throw new NetworkFailureException("gettasklists: httpget failed"); + } catch (JSONException e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + throw new ActionFailureException("get task lists: handing jasonobject failed"); + } + } + + /* + * 通过传入的TASKList的gid,从网络上获取相应属于这个任务列表的任务 + */ + public JSONArray getTaskList(String listGid) throws NetworkFailureException { + commitUpdate(); + try { + JSONObject jsPost = new JSONObject(); + JSONArray actionList = new JSONArray(); + JSONObject action = new JSONObject(); + + // action_list + action.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, + GTaskStringUtils.GTASK_JSON_ACTION_TYPE_GETALL); + action.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, getActionId()); + action.put(GTaskStringUtils.GTASK_JSON_LIST_ID, listGid); //这里设置为传入的listGid + action.put(GTaskStringUtils.GTASK_JSON_GET_DELETED, false); + actionList.put(action); + jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList); + + // client_version + jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion); + + JSONObject jsResponse = postRequest(jsPost); + return jsResponse.getJSONArray(GTaskStringUtils.GTASK_JSON_TASKS); + } catch (JSONException e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + throw new ActionFailureException("get task list: handing jsonobject failed"); + } + } + + public Account getSyncAccount() { + return mAccount; + } + + //重置更新的内容 + public void resetUpdateArray() { + mUpdateArray = null; + } +} + diff --git a/src/notes/gtask/remote/GTaskManager.java b/src/notes/gtask/remote/GTaskManager.java new file mode 100644 index 0000000..9530d72 --- /dev/null +++ b/src/notes/gtask/remote/GTaskManager.java @@ -0,0 +1,887 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.gtask.remote; + +import android.app.Activity; +import android.content.ContentResolver; +import android.content.ContentUris; +import android.content.ContentValues; +import android.content.Context; +import android.database.Cursor; +import android.util.Log; + +import net.micode.notes.R; +import net.micode.notes.data.Notes; +import net.micode.notes.data.Notes.DataColumns; +import net.micode.notes.data.Notes.NoteColumns; +import net.micode.notes.gtask.data.MetaData; +import net.micode.notes.gtask.data.Node; +import net.micode.notes.gtask.data.SqlNote; +import net.micode.notes.gtask.data.Task; +import net.micode.notes.gtask.data.TaskList; +import net.micode.notes.gtask.exception.ActionFailureException; +import net.micode.notes.gtask.exception.NetworkFailureException; +import net.micode.notes.tool.DataUtils; +import net.micode.notes.tool.GTaskStringUtils; + +import org.json.JSONArray; +import org.json.JSONException; +import org.json.JSONObject; + +import java.util.HashMap; +import java.util.HashSet; +import java.util.Iterator; +import java.util.Map; + +public class GTaskManager { + private static final String TAG = GTaskManager.class.getSimpleName(); + public static final int STATE_SUCCESS = 0; + public static final int STATE_NETWORK_ERROR = 1; + public static final int STATE_INTERNAL_ERROR = 2; + public static final int STATE_SYNC_IN_PROGRESS = 3; + public static final int STATE_SYNC_CANCELLED = 4; + private static GTaskManager mInstance = null; + + private Activity mActivity; + private Context mContext; + private ContentResolver mContentResolver; + private boolean mSyncing; + private boolean mCancelled; + private HashMap mGTaskListHashMap; + private HashMap mGTaskHashMap; + private HashMap mMetaHashMap; + private TaskList mMetaList; + private HashSet mLocalDeleteIdMap; + private HashMap mGidToNid; + private HashMap mNidToGid; + + private GTaskManager() { //对象初始化函数 + mSyncing = false; //正在同步,flase代表未执行 + mCancelled = false; //全局标识，flase代表可以执行 + mGTaskListHashMap = new HashMap(); //<>代表Java的泛型,就是创建一个用类型作为参数的类。 + mGTaskHashMap = new HashMap(); + mMetaHashMap = new HashMap(); + mMetaList = null; + mLocalDeleteIdMap = new HashSet(); + mGidToNid = new HashMap(); //GoogleID to NodeID?? + mNidToGid = new HashMap(); //NodeID to GoogleID???通过hashmap散列表建立映射 + } + + /* + * 包含关键字synchronized，语言级同步，指明该函数可能运行在多线程的环境下。 + * 功能：类初始化函数 + * @author TTS + * @return GtaskManger + */ + public static synchronized GTaskManager getInstance() { //可能运行在多线程环境下，使用语言级同步--synchronized + if (mInstance == null) { + mInstance = new GTaskManager(); + } + return mInstance; + } + + /* + * 包含关键字synchronized，语言级同步，指明该函数可能运行在多线程的环境下。 + * @author TTS + * @param activity + */ + public synchronized void setActivityContext(Activity activity) { + // used for getting auth token + mActivity = activity; + } + + /* + * 核心函数 + * 功能：实现了本地同步操作和远端同步操作 + * @author TTS + * @param context-----获取上下文 + * @param asyncTask-------用于同步的异步操作类 + * @return int + */ + public int sync(Context context, GTaskASyncTask asyncTask) { //核心函数 + if (mSyncing) { + Log.d(TAG, "Sync is in progress"); //创建日志文件（调试信息），debug + return STATE_SYNC_IN_PROGRESS; + } + mContext = context; + mContentResolver = mContext.getContentResolver(); + mSyncing = true; + mCancelled = false; + mGTaskListHashMap.clear(); + mGTaskHashMap.clear(); + mMetaHashMap.clear(); + mLocalDeleteIdMap.clear(); + mGidToNid.clear(); + mNidToGid.clear(); + + try { + GTaskClient client = GTaskClient.getInstance(); //getInstance即为创建一个实例,client--客户机 + client.resetUpdateArray(); //JSONArray类型，reset即置为NULL + + // login google task + if (!mCancelled) { + if (!client.login(mActivity)) { + throw new NetworkFailureException("login google task failed"); + } + } + + // get the task list from google + asyncTask.publishProgess(mContext.getString(R.string.sync_progress_init_list)); + initGTaskList(); //获取Google上的JSONtasklist转为本地TaskList + + // do content sync work + asyncTask.publishProgess(mContext.getString(R.string.sync_progress_syncing)); + syncContent(); + } catch (NetworkFailureException e) { //分为两种异常，此类异常为网络异常 + Log.e(TAG, e.toString()); //创建日志文件（调试信息），error + return STATE_NETWORK_ERROR; + } catch (ActionFailureException e) { //此类异常为操作异常 + Log.e(TAG, e.toString()); + return STATE_INTERNAL_ERROR; + } catch (Exception e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + return STATE_INTERNAL_ERROR; + } finally { + mGTaskListHashMap.clear(); + mGTaskHashMap.clear(); + mMetaHashMap.clear(); + mLocalDeleteIdMap.clear(); + mGidToNid.clear(); + mNidToGid.clear(); + mSyncing = false; + } + + return mCancelled ? STATE_SYNC_CANCELLED : STATE_SUCCESS; + } + + /* + *功能：初始化GtaskList，获取Google上的JSONtasklist转为本地TaskList。 + *获得的数据存储在mMetaList，mGTaskListHashMap，mGTaskHashMap + *@author TTS + *@exception NetworkFailureException + *@return void + */ + private void initGTaskList() throws NetworkFailureException { + if (mCancelled) + return; + GTaskClient client = GTaskClient.getInstance(); //getInstance即为创建一个实例，client应指远端客户机 + try { + //Json对象是Name Value对(即子元素)的无序集合，相当于一个Map对象。JsonObject类是bantouyan-json库对Json对象的抽象，提供操纵Json对象的各种方法。 + //其格式为{"key1":value1,"key2",value2....};key 必须是字符串。 + //因为ajax请求不刷新页面，但配合js可以实现局部刷新，因此json常常被用来作为异步请求的返回对象使用。 + JSONArray jsTaskLists = client.getTaskLists(); + + // init meta list first + mMetaList = null; //TaskList类型 + for (int i = 0; i < jsTaskLists.length(); i++) { + JSONObject object = jsTaskLists.getJSONObject(i); //JSONObject与JSONArray一个为对象，一个为数组。此处取出单个JASONObject + String gid = object.getString(GTaskStringUtils.GTASK_JSON_ID); + String name = object.getString(GTaskStringUtils.GTASK_JSON_NAME); + + if (name.equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_META)) { + mMetaList = new TaskList(); //MetaList意为元表,Tasklist类型，此处为初始化 + mMetaList.setContentByRemoteJSON(object); //将JSON中部分数据复制到自己定义的对象中相对应的数据：name->mname... + + // load meta data + JSONArray jsMetas = client.getTaskList(gid); + for (int j = 0; j < jsMetas.length(); j++) { + object = (JSONObject) jsMetas.getJSONObject(j); + MetaData metaData = new MetaData(); //继承自Node + metaData.setContentByRemoteJSON(object); + if (metaData.isWorthSaving()) { //if not worth to save，metadata将不加入mMetaList + mMetaList.addChildTask(metaData); + if (metaData.getGid() != null) { + mMetaHashMap.put(metaData.getRelatedGid(), metaData); + } + } + } + } + } + + // create meta list if not existed + if (mMetaList == null) { + mMetaList = new TaskList(); + mMetaList.setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX + + GTaskStringUtils.FOLDER_META); + GTaskClient.getInstance().createTaskList(mMetaList); + } + + // init task list + for (int i = 0; i < jsTaskLists.length(); i++) { + JSONObject object = jsTaskLists.getJSONObject(i); + String gid = object.getString(GTaskStringUtils.GTASK_JSON_ID); //通过getString函数传入本地某个标志数据的名称，获取其在远端的名称。 + String name = object.getString(GTaskStringUtils.GTASK_JSON_NAME); + + if (name.startsWith(GTaskStringUtils.MIUI_FOLDER_PREFFIX) + && !name.equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX + + GTaskStringUtils.FOLDER_META)) { + TaskList tasklist = new TaskList(); //继承自Node + tasklist.setContentByRemoteJSON(object); + mGTaskListHashMap.put(gid, tasklist); + mGTaskHashMap.put(gid, tasklist); //为什么加两遍？？？ + + // load tasks + JSONArray jsTasks = client.getTaskList(gid); + for (int j = 0; j < jsTasks.length(); j++) { + object = (JSONObject) jsTasks.getJSONObject(j); + gid = object.getString(GTaskStringUtils.GTASK_JSON_ID); + Task task = new Task(); + task.setContentByRemoteJSON(object); + if (task.isWorthSaving()) { + task.setMetaInfo(mMetaHashMap.get(gid)); + tasklist.addChildTask(task); + mGTaskHashMap.put(gid, task); + } + } + } + } + } catch (JSONException e) { + Log.e(TAG, e.toString()); + e.printStackTrace(); + throw new ActionFailureException("initGTaskList: handing JSONObject failed"); + } + } + + /* + * 功能：本地内容同步操作 + * @throws NetworkFailureException + * @return 无返回值 + */ + private void syncContent() throws NetworkFailureException { //本地内容同步操作 + int syncType; + Cursor c = null; //数据库指针 + String gid; //GoogleID?? + Node node; //Node包含Sync_Action的不同类型 + + mLocalDeleteIdMap.clear(); //HashSet类型 + + if (mCancelled) { + return; + } + + // for local deleted note + try { + c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE, + "(type<>? AND parent_id=?)", new String[] { + String.valueOf(Notes.TYPE_SYSTEM), String.valueOf(Notes.ID_TRASH_FOLER) + }, null); + if (c != null) { + while (c.moveToNext()) { + gid = c.getString(SqlNote.GTASK_ID_COLUMN); + node = mGTaskHashMap.get(gid); + if (node != null) { + mGTaskHashMap.remove(gid); + doContentSync(Node.SYNC_ACTION_DEL_REMOTE, node, c); + } + + mLocalDeleteIdMap.add(c.getLong(SqlNote.ID_COLUMN)); + } + } else { + Log.w(TAG, "failed to query trash folder"); + } + } finally { + if (c != null) { + c.close(); + c = null; + } + } + + // sync folder first + syncFolder(); + + // for note existing in database + try { + c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE, + "(type=? AND parent_id<>?)", new String[] { + String.valueOf(Notes.TYPE_NOTE), String.valueOf(Notes.ID_TRASH_FOLER) + }, NoteColumns.TYPE + " DESC"); + if (c != null) { + while (c.moveToNext()) { + gid = c.getString(SqlNote.GTASK_ID_COLUMN); + node = mGTaskHashMap.get(gid); + if (node != null) { + mGTaskHashMap.remove(gid); + mGidToNid.put(gid, c.getLong(SqlNote.ID_COLUMN)); //通过hashmap建立联系 + mNidToGid.put(c.getLong(SqlNote.ID_COLUMN), gid); //通过hashmap建立联系 + syncType = node.getSyncAction(c); + } else { + if (c.getString(SqlNote.GTASK_ID_COLUMN).trim().length() == 0) { + // local add + syncType = Node.SYNC_ACTION_ADD_REMOTE; + } else { + // remote delete + syncType = Node.SYNC_ACTION_DEL_LOCAL; + } + } + doContentSync(syncType, node, c); + } + } else { + Log.w(TAG, "failed to query existing note in database"); + } + + } finally { + if (c != null) { + c.close(); + c = null; + } + } + + // go through remaining items + Iterator> iter = mGTaskHashMap.entrySet().iterator(); //Iterator迭代器 + while (iter.hasNext()) { + Map.Entry entry = iter.next(); + node = entry.getValue(); + doContentSync(Node.SYNC_ACTION_ADD_LOCAL, node, null); + } + + // mCancelled can be set by another thread, so we neet to check one by //thread----线程 + // one + // clear local delete table + if (!mCancelled) { + if (!DataUtils.batchDeleteNotes(mContentResolver, mLocalDeleteIdMap)) { + throw new ActionFailureException("failed to batch-delete local deleted notes"); + } + } + + // refresh local sync id + if (!mCancelled) { + GTaskClient.getInstance().commitUpdate(); + refreshLocalSyncId(); + } + + } + private void syncFolder() throws NetworkFailureException { + Cursor c = null; + String gid; + Node node; + int syncType; + + if (mCancelled) { + return; + } + + // for root folder + try { + c = mContentResolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, + Notes.ID_ROOT_FOLDER), SqlNote.PROJECTION_NOTE, null, null, null); + if (c != null) { + c.moveToNext(); + gid = c.getString(SqlNote.GTASK_ID_COLUMN); + node = mGTaskHashMap.get(gid); + if (node != null) { + mGTaskHashMap.remove(gid); + mGidToNid.put(gid, (long) Notes.ID_ROOT_FOLDER); + mNidToGid.put((long) Notes.ID_ROOT_FOLDER, gid); + // for system folder, only update remote name if necessary + if (!node.getName().equals( + GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT)) + doContentSync(Node.SYNC_ACTION_UPDATE_REMOTE, node, c); + } else { + doContentSync(Node.SYNC_ACTION_ADD_REMOTE, node, c); + } + } else { + Log.w(TAG, "failed to query root folder"); + } + } finally { + if (c != null) { + c.close(); + c = null; + } + } + + // for call-note folder + try { + c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE, "(_id=?)", + new String[] { + String.valueOf(Notes.ID_CALL_RECORD_FOLDER) + }, null); + if (c != null) { + if (c.moveToNext()) { + gid = c.getString(SqlNote.GTASK_ID_COLUMN); + node = mGTaskHashMap.get(gid); + if (node != null) { + mGTaskHashMap.remove(gid); + mGidToNid.put(gid, (long) Notes.ID_CALL_RECORD_FOLDER); + mNidToGid.put((long) Notes.ID_CALL_RECORD_FOLDER, gid); + // for system folder, only update remote name if + // necessary + if (!node.getName().equals( + GTaskStringUtils.MIUI_FOLDER_PREFFIX + + GTaskStringUtils.FOLDER_CALL_NOTE)) + doContentSync(Node.SYNC_ACTION_UPDATE_REMOTE, node, c); + } else { + doContentSync(Node.SYNC_ACTION_ADD_REMOTE, node, c); + } + } + } else { + Log.w(TAG, "failed to query call note folder"); + } + } finally { + if (c != null) { + c.close(); + c = null; + } + } + + // for local existing folders + try { + c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE, + "(type=? AND parent_id<>?)", new String[] { + String.valueOf(Notes.TYPE_FOLDER), String.valueOf(Notes.ID_TRASH_FOLER) + }, NoteColumns.TYPE + " DESC"); + if (c != null) { + while (c.moveToNext()) { + gid = c.getString(SqlNote.GTASK_ID_COLUMN); + node = mGTaskHashMap.get(gid); + if (node != null) { + mGTaskHashMap.remove(gid); + mGidToNid.put(gid, c.getLong(SqlNote.ID_COLUMN)); + mNidToGid.put(c.getLong(SqlNote.ID_COLUMN), gid); + syncType = node.getSyncAction(c); + } else { + if (c.getString(SqlNote.GTASK_ID_COLUMN).trim().length() == 0) { + // local add + syncType = Node.SYNC_ACTION_ADD_REMOTE; + } else { + // remote delete + syncType = Node.SYNC_ACTION_DEL_LOCAL; + } + } + doContentSync(syncType, node, c); + } + } else { + Log.w(TAG, "failed to query existing folder"); + } + } finally { + if (c != null) { + c.close(); + c = null; + } + } + + // for remote add folders + Iterator> iter = mGTaskListHashMap.entrySet().iterator(); + while (iter.hasNext()) { + Map.Entry entry = iter.next(); + gid = entry.getKey(); + node = entry.getValue(); + if (mGTaskHashMap.containsKey(gid)) { + mGTaskHashMap.remove(gid); + doContentSync(Node.SYNC_ACTION_ADD_LOCAL, node, null); + } + } + + if (!mCancelled) + GTaskClient.getInstance().commitUpdate(); + } + + /* + * 功能：syncType分类，addLocalNode，addRemoteNode，deleteNode，updateLocalNode，updateRemoteNode + * @author TTS + * @param syncType + * @param node + * @param c + * @throws NetworkFailureException + */ + private void doContentSync(int syncType, Node node, Cursor c) throws NetworkFailureException { + if (mCancelled) { + return; + } + + MetaData meta; + switch (syncType) { + case Node.SYNC_ACTION_ADD_LOCAL: + addLocalNode(node); + break; + case Node.SYNC_ACTION_ADD_REMOTE: + addRemoteNode(node, c); + break; + case Node.SYNC_ACTION_DEL_LOCAL: + meta = mMetaHashMap.get(c.getString(SqlNote.GTASK_ID_COLUMN)); + if (meta != null) { + GTaskClient.getInstance().deleteNode(meta); + } + mLocalDeleteIdMap.add(c.getLong(SqlNote.ID_COLUMN)); + break; + case Node.SYNC_ACTION_DEL_REMOTE: + meta = mMetaHashMap.get(node.getGid()); + if (meta != null) { + GTaskClient.getInstance().deleteNode(meta); + } + GTaskClient.getInstance().deleteNode(node); + break; + case Node.SYNC_ACTION_UPDATE_LOCAL: + updateLocalNode(node, c); + break; + case Node.SYNC_ACTION_UPDATE_REMOTE: + updateRemoteNode(node, c); + break; + case Node.SYNC_ACTION_UPDATE_CONFLICT: + // merging both modifications maybe a good idea + // right now just use local update simply + updateRemoteNode(node, c); + break; + case Node.SYNC_ACTION_NONE: + break; + case Node.SYNC_ACTION_ERROR: + default: + throw new ActionFailureException("unkown sync action type"); + } + } + + /* + * 功能：本地增加Node + * @author TTS + * @param node + * @throws NetworkFailureException + */ + private void addLocalNode(Node node) throws NetworkFailureException { + if (mCancelled) { + return; + } + + SqlNote sqlNote; + if (node instanceof TaskList) { + if (node.getName().equals( + GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT)) { + sqlNote = new SqlNote(mContext, Notes.ID_ROOT_FOLDER); + } else if (node.getName().equals( + GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_CALL_NOTE)) { + sqlNote = new SqlNote(mContext, Notes.ID_CALL_RECORD_FOLDER); + } else { + sqlNote = new SqlNote(mContext); + sqlNote.setContent(node.getLocalJSONFromContent()); + sqlNote.setParentId(Notes.ID_ROOT_FOLDER); + } + } else { + sqlNote = new SqlNote(mContext); + JSONObject js = node.getLocalJSONFromContent(); + try { + if (js.has(GTaskStringUtils.META_HEAD_NOTE)) { + JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE); + if (note.has(NoteColumns.ID)) { + long id = note.getLong(NoteColumns.ID); + if (DataUtils.existInNoteDatabase(mContentResolver, id)) { + // the id is not available, have to create a new one + note.remove(NoteColumns.ID); + } + } + } + + if (js.has(GTaskStringUtils.META_HEAD_DATA)) { + JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA); + for (int i = 0; i < dataArray.length(); i++) { + JSONObject data = dataArray.getJSONObject(i); + if (data.has(DataColumns.ID)) { + long dataId = data.getLong(DataColumns.ID); + if (DataUtils.existInDataDatabase(mContentResolver, dataId)) { + // the data id is not available, have to create + // a new one + data.remove(DataColumns.ID); + } + } + } + + } + } catch (JSONException e) { + Log.w(TAG, e.toString()); + e.printStackTrace(); + } + sqlNote.setContent(js); + + Long parentId = mGidToNid.get(((Task) node).getParent().getGid()); + if (parentId == null) { + Log.e(TAG, "cannot find task's parent id locally"); + throw new ActionFailureException("cannot add local node"); + } + sqlNote.setParentId(parentId.longValue()); + } + + // create the local node + sqlNote.setGtaskId(node.getGid()); + sqlNote.commit(false); + + // update gid-nid mapping + mGidToNid.put(node.getGid(), sqlNote.getId()); + mNidToGid.put(sqlNote.getId(), node.getGid()); + + // update meta + updateRemoteMeta(node.getGid(), sqlNote); + } + + /* + * 功能：update本地node + * @author TTS + * @param node + * ----同步操作的基础数据类型 + * @param c + * ----Cursor + * @throws NetworkFailureException + */ + private void updateLocalNode(Node node, Cursor c) throws NetworkFailureException { + if (mCancelled) { + return; + } + + SqlNote sqlNote; + // update the note locally + sqlNote = new SqlNote(mContext, c); + sqlNote.setContent(node.getLocalJSONFromContent()); + + Long parentId = (node instanceof Task) ? mGidToNid.get(((Task) node).getParent().getGid()) + : new Long(Notes.ID_ROOT_FOLDER); + if (parentId == null) { + Log.e(TAG, "cannot find task's parent id locally"); + throw new ActionFailureException("cannot update local node"); + } + sqlNote.setParentId(parentId.longValue()); + sqlNote.commit(true); + + // update meta info + updateRemoteMeta(node.getGid(), sqlNote); + } + + /* + * 功能：远程增加Node + * 需要updateRemoteMeta + * @author TTS + * @param node + * ----同步操作的基础数据类型 + * @param c + * --Cursor + * @throws NetworkFailureException + */ + private void addRemoteNode(Node node, Cursor c) throws NetworkFailureException { + if (mCancelled) { + return; + } + + SqlNote sqlNote = new SqlNote(mContext, c); //从本地mContext中获取内容 + Node n; + + // update remotely + if (sqlNote.isNoteType()) { + Task task = new Task(); + task.setContentByLocalJSON(sqlNote.getContent()); + + String parentGid = mNidToGid.get(sqlNote.getParentId()); + if (parentGid == null) { + Log.e(TAG, "cannot find task's parent tasklist"); //调试信息 + throw new ActionFailureException("cannot add remote task"); + } + mGTaskListHashMap.get(parentGid).addChildTask(task); //在本地生成的GTaskList中增加子结点 + + //登录远程服务器，创建Task + GTaskClient.getInstance().createTask(task); + n = (Node) task; + + // add meta + updateRemoteMeta(task.getGid(), sqlNote); + } else { + TaskList tasklist = null; + + // we need to skip folder if it has already existed + String folderName = GTaskStringUtils.MIUI_FOLDER_PREFFIX; + if (sqlNote.getId() == Notes.ID_ROOT_FOLDER) + folderName += GTaskStringUtils.FOLDER_DEFAULT; + else if (sqlNote.getId() == Notes.ID_CALL_RECORD_FOLDER) + folderName += GTaskStringUtils.FOLDER_CALL_NOTE; + else + folderName += sqlNote.getSnippet(); + + //iterator迭代器，通过统一的接口迭代所有的map元素 + Iterator> iter = mGTaskListHashMap.entrySet().iterator(); + while (iter.hasNext()) { + Map.Entry entry = iter.next(); + String gid = entry.getKey(); + TaskList list = entry.getValue(); + + if (list.getName().equals(folderName)) { + tasklist = list; + if (mGTaskHashMap.containsKey(gid)) { + mGTaskHashMap.remove(gid); + } + break; + } + } + + // no match we can add now + if (tasklist == null) { + tasklist = new TaskList(); + tasklist.setContentByLocalJSON(sqlNote.getContent()); + GTaskClient.getInstance().createTaskList(tasklist); + mGTaskListHashMap.put(tasklist.getGid(), tasklist); + } + n = (Node) tasklist; + } + + // update local note + sqlNote.setGtaskId(n.getGid()); + sqlNote.commit(false); + sqlNote.resetLocalModified(); + sqlNote.commit(true); + + // gid-id mapping 创建id间的映射 + mGidToNid.put(n.getGid(), sqlNote.getId()); + mNidToGid.put(sqlNote.getId(), n.getGid()); + } + + /* + * 功能：更新远端的Node，包含meta更新(updateRemoteMeta) + * @author TTS + * @param node + * ----同步操作的基础数据类型 + * @param c + * --Cursor + * @throws NetworkFailureException + */ + private void updateRemoteNode(Node node, Cursor c) throws NetworkFailureException { + if (mCancelled) { + return; + } + + SqlNote sqlNote = new SqlNote(mContext, c); + + // update remotely + node.setContentByLocalJSON(sqlNote.getContent()); + GTaskClient.getInstance().addUpdateNode(node); //GTaskClient用途为从本地登陆远端服务器 + + // update meta + updateRemoteMeta(node.getGid(), sqlNote); + + // move task if necessary + if (sqlNote.isNoteType()) { + Task task = (Task) node; + TaskList preParentList = task.getParent(); + //preParentList为通过node获取的父节点列表 + + String curParentGid = mNidToGid.get(sqlNote.getParentId()); + //curParentGid为通过光标在数据库中找到sqlNote的mParentId，再通过mNidToGid由long类型转为String类型的Gid + + if (curParentGid == null) { + Log.e(TAG, "cannot find task's parent tasklist"); + throw new ActionFailureException("cannot update remote task"); + } + TaskList curParentList = mGTaskListHashMap.get(curParentGid); + //通过HashMap找到对应Gid的TaskList + + if (preParentList != curParentList) { + preParentList.removeChildTask(task); + curParentList.addChildTask(task); + GTaskClient.getInstance().moveTask(task, preParentList, curParentList); + } + } + + // clear local modified flag + sqlNote.resetLocalModified(); + //commit到本地数据库 + sqlNote.commit(true); + } + + /* + * 功能：升级远程meta。 meta---元数据----计算机文件系统管理数据---管理数据的数据。 + * @author TTS + * @param gid + * ---GoogleID为String类型 + * @param sqlNote + * ---同步前的数据库操作，故使用类SqlNote + * @throws NetworkFailureException + */ + private void updateRemoteMeta(String gid, SqlNote sqlNote) throws NetworkFailureException { + if (sqlNote != null && sqlNote.isNoteType()) { + MetaData metaData = mMetaHashMap.get(gid); + if (metaData != null) { + metaData.setMeta(gid, sqlNote.getContent()); + GTaskClient.getInstance().addUpdateNode(metaData); + } else { + metaData = new MetaData(); + metaData.setMeta(gid, sqlNote.getContent()); + mMetaList.addChildTask(metaData); + mMetaHashMap.put(gid, metaData); + GTaskClient.getInstance().createTask(metaData); + } + } + } + + /* + * 功能：刷新本地，给sync的ID对应上最后更改过的对象 + * @author TTS + * @return void + * @throws NetworkFailureException + */ + private void refreshLocalSyncId() throws NetworkFailureException { + if (mCancelled) { + return; + } + + // get the latest gtask list //获取最近的（最晚的）gtask list + mGTaskHashMap.clear(); + mGTaskListHashMap.clear(); + mMetaHashMap.clear(); + initGTaskList(); + + Cursor c = null; + try { + c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE, + "(type<>? AND parent_id<>?)", new String[] { + String.valueOf(Notes.TYPE_SYSTEM), String.valueOf(Notes.ID_TRASH_FOLER) + }, NoteColumns.TYPE + " DESC"); //query语句：五个参数，NoteColumns.TYPE + " DESC"-----为按类型递减顺序返回查询结果。new String[] {String.valueOf(Notes.TYPE_SYSTEM), String.valueOf(Notes.ID_TRASH_FOLER)}------为选择参数。"(type<>? AND parent_id<>?)"-------指明返回行过滤器。SqlNote.PROJECTION_NOTE--------应返回的数据列的名字。Notes.CONTENT_NOTE_URI--------contentProvider包含所有数据集所对应的uri + if (c != null) { + while (c.moveToNext()) { + String gid = c.getString(SqlNote.GTASK_ID_COLUMN); + Node node = mGTaskHashMap.get(gid); + if (node != null) { + mGTaskHashMap.remove(gid); + ContentValues values = new ContentValues(); //在ContentValues中创建键值对。准备通过contentResolver写入数据 + values.put(NoteColumns.SYNC_ID, node.getLastModified()); + mContentResolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, //进行批量更改，选择参数为NULL，应该可以用insert替换，参数分别为表名和需要更新的value对象。 + c.getLong(SqlNote.ID_COLUMN)), values, null, null); + } else { + Log.e(TAG, "something is missed"); + throw new ActionFailureException( + "some local items don't have gid after sync"); + } + } + } else { + Log.w(TAG, "failed to query local note to refresh sync id"); + } + } finally { + if (c != null) { + c.close(); + c = null; + } + } + } + + /* + * 功能：获取同步账号,mAccount.name + * @author TTS + * @return String + */ + public String getSyncAccount() { + return GTaskClient.getInstance().getSyncAccount().name; + } + + /* + * 功能：取消同步，置mCancelled为true + * @author TTS + */ + public void cancelSync() { + mCancelled = true; + } +} diff --git a/src/notes/gtask/remote/GTaskSyncService.java b/src/notes/gtask/remote/GTaskSyncService.java new file mode 100644 index 0000000..0a7c08b --- /dev/null +++ b/src/notes/gtask/remote/GTaskSyncService.java @@ -0,0 +1,143 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.gtask.remote; + +/* + * GTask 同步服务，用于提供同步服务 （开始、取消同步），发送广播 + * 主要方法： + * private void startSync() 启动一个同步工作 + * private void cancelSync() 取消同步 + * public void onCreate() + * public int onStartCommand(Intent intent, int flags, int startId) service生命周期的组成部分，相当于重启service（比如在被暂停之后），而不是创建一个新的service + * public void onLowMemory() 在没有内存的情况下如果存在service则结束掉这的service + * public IBinder onBind() + * public void sendBroadcast(String msg) 发送同步的相关通知 + * public static void startSync(Activity activity) + * public static void cancelSync(Context context) + * public static boolean isSyncing() 判读是否在进行同步 + * public static String getProgressString() 获取当前进度的信息 + */ +import android.app.Activity; +import android.app.Service; +import android.content.Context; +import android.content.Intent; +import android.os.Bundle; +import android.os.IBinder; + +public class GTaskSyncService extends Service { + public final static String ACTION_STRING_NAME = "sync_action_type"; + + public final static int ACTION_START_SYNC = 0; + + public final static int ACTION_CANCEL_SYNC = 1; + + public final static int ACTION_INVALID = 2; + + public final static String GTASK_SERVICE_BROADCAST_NAME = "net.micode.notes.gtask.remote.gtask_sync_service"; + + public final static String GTASK_SERVICE_BROADCAST_IS_SYNCING = "isSyncing"; + + public final static String GTASK_SERVICE_BROADCAST_PROGRESS_MSG = "progressMsg"; + + private static GTaskASyncTask mSyncTask = null; + + private static String mSyncProgress = ""; + //开始同步 + private void startSync() { + if (mSyncTask == null) { + mSyncTask = new GTaskASyncTask(this, new GTaskASyncTask.OnCompleteListener() { + public void onComplete() { + mSyncTask = null; + sendBroadcast(""); + stopSelf(); + } + }); + sendBroadcast(""); + mSyncTask.execute();//这个函数让任务是以单线程队列方式或线程池队列方式运行 + } + } + + private void cancelSync() { + if (mSyncTask != null) { + mSyncTask.cancelSync(); + } + } + + @Override + public void onCreate() { + mSyncTask = null; + } + + @Override + public int onStartCommand(Intent intent, int flags, int startId) { + Bundle bundle = intent.getExtras(); + if (bundle != null && bundle.containsKey(ACTION_STRING_NAME)) {//开始同步和取消同步的不同情况 + switch (bundle.getInt(ACTION_STRING_NAME, ACTION_INVALID)) { + case ACTION_START_SYNC: + startSync(); + break; + case ACTION_CANCEL_SYNC: + cancelSync(); + break; + default: + break; + } + return START_STICKY;//等待新的intent到这个service继续运行 + } + return super.onStartCommand(intent, flags, startId); + } + + @Override + public void onLowMemory() { + if (mSyncTask != null) { + mSyncTask.cancelSync(); + } + } + + public IBinder onBind(Intent intent) { + return null; + } + + public void sendBroadcast(String msg) { + mSyncProgress = msg; + Intent intent = new Intent(GTASK_SERVICE_BROADCAST_NAME);//创建一个新的Intent + intent.putExtra(GTASK_SERVICE_BROADCAST_IS_SYNCING, mSyncTask != null);//添加Intent中相应参数的值 + intent.putExtra(GTASK_SERVICE_BROADCAST_PROGRESS_MSG, msg); + sendBroadcast(intent); //开始发送通知 + } + + public static void startSync(Activity activity) {//执行一个service，即开始同步 + GTaskManager.getInstance().setActivityContext(activity); + Intent intent = new Intent(activity, GTaskSyncService.class); + intent.putExtra(GTaskSyncService.ACTION_STRING_NAME, GTaskSyncService.ACTION_START_SYNC); + activity.startService(intent); + } + + public static void cancelSync(Context context) {//执行一个service，即取消同步 + Intent intent = new Intent(context, GTaskSyncService.class); + intent.putExtra(GTaskSyncService.ACTION_STRING_NAME, GTaskSyncService.ACTION_CANCEL_SYNC); + context.startService(intent); + } + + public static boolean isSyncing() { + return mSyncTask != null; + } + + public static String getProgressString() { + return mSyncProgress; + } +} diff --git a/src/notes/ui/AlarmAlertActivity.java b/src/notes/ui/AlarmAlertActivity.java new file mode 100644 index 0000000..aea9c89 --- /dev/null +++ b/src/notes/ui/AlarmAlertActivity.java @@ -0,0 +1,159 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +//以上代码用于实现提醒功能：关于许可证使用问题 +package net.micode.notes.ui;//引入notes.ui开发包 +//以下import各种库文件，后续需要使用 +import android.app.Activity;//导入Activity包 +import android.app.AlertDialog;//弹出警告对话框 +import android.content.Context;//提供了有关应用程序的全局信息 +//content主要是和数据库进行交互,对数据库进行增删改查操作 +import android.content.DialogInterface;//在界面弹出对话框 +import android.content.DialogInterface.OnClickListener;//点击事件的监听器实现方式 +import android.content.DialogInterface.OnDismissListener;//解散监听器 +import android.content.Intent; +import android.media.AudioManager;//引入媒体控制类 +import android.media.MediaPlayer;//引入媒体播放器 +import android.media.RingtoneManager;//媒体铃声控制 +import android.net.Uri; +import android.os.Bundle; +import android.os.PowerManager; +import android.provider.Settings;//引入设置类 +import android.view.Window;//窗口视图 +import android.view.WindowManager;//窗口管理 + +import net.micode.notes.R; +import net.micode.notes.data.Notes; +import net.micode.notes.tool.DataUtils; + +import java.io.IOException;//调用以上三个类及一些android库函数 + + +public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {//继承拓展Activity类并实现两个接口 + private long mNoteId;//声明存储在数据库中的便签ID号 + private String mSnippet; //闹钟提示的文本内容 + private static final int SNIPPET_PREW_MAX_LEN = 60;//声明文本（摘要）的最大长度为60 + MediaPlayer mPlayer;//实例化一个多媒体播放器 + + @Override + protected void onCreate(Bundle savedInstanceState) {//重写onCreate方法 + super.onCreate(savedInstanceState);//使用super调用父类的onCreate函数 + requestWindowFeature(Window.FEATURE_NO_TITLE);//隐藏标题栏 + + final Window win = getWindow();//获取一个无标题的窗口实例 + win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);//锁屏时也能显示窗口 + + if (!isScreenOn()) {//若屏幕为关闭状态 + win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON//事件启动时使屏幕保持常亮 + | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON//事件启动时能点亮屏幕 + | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON//窗体点亮时允许锁屏 + | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);//当使用这个flag时,window manager会报告插入window的矩形大小 + } + + Intent intent = getIntent();//通过getIntent()获得的Intent用于开启Activity + + try {//语句块：异常处理，当要程序出现错误时可以不中断继续运行下去 + mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));//获取便签ID + mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);//根据上一行获取的ID号来从数据库中读取该ID号的内容 + mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0, + SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info) + : mSnippet;//比较片段的长度，若大于最大长度，则截取最大长度+‘...’ + } catch (IllegalArgumentException e) {//捕获异常并进行处理 + e.printStackTrace();//打印出详细的异常信息 + return; + } + + mPlayer = new MediaPlayer();//新建媒体播放器 + if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {//由该便签的id从数据库中获取其类型，判断是否为需要提醒的便签 + showActionDialog();//弹出对话框 + playAlarmSound();//播放闹钟提示音 + } else { + finish();//结束闹钟动作 + } + } + + private boolean isScreenOn() {//判断是否出现在屏幕上 + PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);//获得PowerManager的实例 + return pm.isScreenOn();//判断屏幕是否打开 + } + + private void playAlarmSound() {//播放提示音 + Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);//调用系统的铃声管理URI，得到闹钟提示音 + + int silentModeStreams = Settings.System.getInt(getContentResolver(),//判断当前是否为静音状态 + Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0); + + if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {//获取到当前是否为静音模式 + mPlayer.setAudioStreamType(silentModeStreams);//使媒体播放器静音 + } else { + mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);//使媒体播放器发出警报 + } + try { + mPlayer.setDataSource(this, url);//设置播放器的数据源url + mPlayer.prepare();//进行播放器的准备 + mPlayer.setLooping(true);//设置播放器循环播放 + mPlayer.start();//开始播放 + } catch (IllegalArgumentException e) {//异常处理：非法参数异常 + // TODO Auto-generated catch block + e.printStackTrace();//打印出详细的异常信息，异常名称 + } catch (SecurityException e) {//安全异常 + // TODO Auto-generated catch block + e.printStackTrace(); + } catch (IllegalStateException e) {//非法状态异常 + // TODO Auto-generated catch block + e.printStackTrace(); + } catch (IOException e) {//输入输出异常 + // TODO Auto-generated catch block + e.printStackTrace(); + } + } + + private void showActionDialog() {//显示提示框 + AlertDialog.Builder dialog = new AlertDialog.Builder(this);//新建一个对话框 + dialog.setTitle(R.string.app_name);//为对话框设置标题 + dialog.setMessage(mSnippet);//设置对话框文本内容 + dialog.setPositiveButton(R.string.notealert_ok, this);//设置“OK”按钮 + if (isScreenOn()) {//若屏幕为开启状态 + dialog.setNegativeButton(R.string.notealert_enter, this);//对话框添加不成功按钮 + } + dialog.show().setOnDismissListener(this);//将对话框展示出来，并且设置一个监听器用来取消对话框 + } + + public void onClick(DialogInterface dialog, int which) {//根据点击执行对话框任务 + switch (which) { + case DialogInterface.BUTTON_NEGATIVE://取消操作 + Intent intent = new Intent(this, NoteEditActivity.class);//实现与NoteEditActivity类之间的数据传输 + intent.setAction(Intent.ACTION_VIEW);//设置动作的属性 + intent.putExtra(Intent.EXTRA_UID, mNoteId);//附加便签的id + startActivity(intent);//开始动作 + break; + default: + break; + } + } + + public void onDismiss(DialogInterface dialog) {//提示框消失事件处理 + stopAlarmSound();//停止响铃 + finish(); + } + + private void stopAlarmSound() {//关闭闹钟铃音 + if (mPlayer != null) {//如果播放器仍然存在 + mPlayer.stop();//停止播放 + mPlayer.release();//释放 + mPlayer = null;//清空播放器资源 + } + } +} diff --git a/src/notes/ui/AlarmInitReceiver.java b/src/notes/ui/AlarmInitReceiver.java new file mode 100644 index 0000000..edccf4b --- /dev/null +++ b/src/notes/ui/AlarmInitReceiver.java @@ -0,0 +1,65 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +//提醒关于许可证使用的相关问题 +package net.micode.notes.ui; + +import android.app.AlarmManager;//引入闹钟提醒包 +import android.app.PendingIntent; +import android.content.BroadcastReceiver;//监听开机广播 +import android.content.ContentUris;//内容链接 +import android.content.Context;//文本 +import android.content.Intent; +import android.database.Cursor;//目的和光标 + +import net.micode.notes.data.Notes; +import net.micode.notes.data.Notes.NoteColumns;//便签栏 + + +public class AlarmInitReceiver extends BroadcastReceiver {//实现接受闹铃启动消息的功能 + + private static final String [] PROJECTION = new String [] {//声明PROJECTION，每个元素包括id和提醒日期 + NoteColumns.ID, + NoteColumns.ALERTED_DATE + }; + + private static final int COLUMN_ID = 0; + private static final int COLUMN_ALERTED_DATE = 1;//设定ID和闹钟信息的初始值 + + @Override + public void onReceive(Context context, Intent intent) {//接收广播后的处理过程 + long currentDate = System.currentTimeMillis();//通过系统函数获了当前时间，存入currentDate变量。 + Cursor c = context.getContentResolver().query(Notes.CONTENT_NOTE_URI,//通过查找数据库中的标签内容，找到和当前系统时间相等的标签 + PROJECTION, + NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE,//获取的时间如果大于设置的时间的提醒项目 + new String[] { String.valueOf(currentDate) }, + null);//类型转换，将long类型的currentDate转变为String类 + + if (c != null) { + if (c.moveToFirst()) {//游标移动到开始位置 + do { + long alertDate = c.getLong(COLUMN_ALERTED_DATE);//获取要提醒的日期 + Intent sender = new Intent(context, AlarmReceiver.class);//新建一个intent类来指向alarmreceiver 来传输数据 + sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID)));//设置数据为便签的uri和id + PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0);//创建一个广播组件，可以在手机广播栏显示相应内容 + AlarmManager alermManager = (AlarmManager) context//新建系统的闹钟服务 + .getSystemService(Context.ALARM_SERVICE); + alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);//设置一系列需要传输的数据 + } while (c.moveToNext());//游标移动到下一位置 + } + c.close();//关闭游标 + } + } +} diff --git a/src/notes/ui/AlarmReceiver.java b/src/notes/ui/AlarmReceiver.java new file mode 100644 index 0000000..f5ed4f5 --- /dev/null +++ b/src/notes/ui/AlarmReceiver.java @@ -0,0 +1,30 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.ui; + +import android.content.BroadcastReceiver;//接收广播并启动 AlarmAlertActivity类 +import android.content.Context;//环境 +import android.content.Intent;//文本意向 + +public class AlarmReceiver extends BroadcastReceiver {//闹钟接收器，继承自广播接收器 + @Override + public void onReceive(Context context, Intent intent) {//重载Onreceive()方法，实现对广播的侦听，由此实现对接受闹铃启动消息的功能 + intent.setClass(context, AlarmAlertActivity.class);//从当前的Intent启动AlarmAlertActivity，即组件之间的跳转 + intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);//为该intent添加flag，使其加入一个新的task栈中 + context.startActivity(intent);//使用intent启动Activity + } +} diff --git a/src/notes/ui/DateTimePicker.java b/src/notes/ui/DateTimePicker.java new file mode 100644 index 0000000..8199eee --- /dev/null +++ b/src/notes/ui/DateTimePicker.java @@ -0,0 +1,485 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.ui;//引入ui包 + +import java.text.DateFormatSymbols; +import java.util.Calendar;//日历 + +import net.micode.notes.R; + + +import android.content.Context;//文本环境 +import android.text.format.DateFormat; +import android.view.View;//看法 +import android.widget.FrameLayout; +import android.widget.NumberPicker;//数字选择器 + +public class DateTimePicker extends FrameLayout {//继承FrameLayout类，时间日期选择器 + + private static final boolean DEFAULT_ENABLE_STATE = true; + //以下设置时间参数与变量 + private static final int HOURS_IN_HALF_DAY = 12;//半天12小时 + private static final int HOURS_IN_ALL_DAY = 24;//一整天24小时 + private static final int DAYS_IN_ALL_WEEK = 7;//一周七天 + private static final int DATE_SPINNER_MIN_VAL = 0;//日期循环最小值为0 + private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1;//日期轮转最大值为6 + private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0;//24小时制小时最小值为0 + private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23;//24小时制小时最大值为23 + private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1;//12小时制最小为1 + private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12;//12小时制最大为12 + private static final int MINUT_SPINNER_MIN_VAL = 0;//分钟数最小值为0 + private static final int MINUT_SPINNER_MAX_VAL = 59;//分钟数最大值为59 + private static final int AMPM_SPINNER_MIN_VAL = 0;//上午开始为0 + private static final int AMPM_SPINNER_MAX_VAL = 1;//下午开始标志为1 + + private final NumberPicker mDateSpinner;//初始化控件 + private final NumberPicker mHourSpinner;//数字选择器，用于让用户输入数值 + private final NumberPicker mMinuteSpinner;//定义一个分钟挂件 + private final NumberPicker mAmPmSpinner;//定义一个上下午转轮 + private Calendar mDate;//定义一个日历类型的日期变量 + + private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK];//定义一个展示时间的字符串 + + private boolean mIsAm;//设置日期改变的监听器 + + private boolean mIs24HourView;//是否以24小时查看时间 + + private boolean mIsEnabled = DEFAULT_ENABLE_STATE;//变量表示是否已开启 + + private boolean mInitialising;//判断是否初始化 + + private OnDateTimeChangedListener mOnDateTimeChangedListener;//日期变化监听器 + + private NumberPicker.OnValueChangeListener mOnDateChangedListener = new NumberPicker.OnValueChangeListener() {//监听日期变化，传送给mDate并进行同步更新操作 + @Override + public void onValueChange(NumberPicker picker, int oldVal, int newVal) {//重写监听日期的变化语句 + mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal);//根据日期新旧值，改变日历 + updateDateControl();//更新日期控制 + onDateTimeChanged();//监听日期时间变化 + } + }; + + private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() {//以小时为单位的监听器 + @Override + public void onValueChange(NumberPicker picker, int oldVal, int newVal) {//小时变化进行更新，天数变化进行更新 + boolean isDateChanged = false;//默认日期没有变化 + Calendar cal = Calendar.getInstance();//创建一个日历 + if (!mIs24HourView) {//不是24小时制 + if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) {//对于12小时制，11点和12点进行交替时的操作 + cal.setTimeInMillis(mDate.getTimeInMillis());//将参数的值作为系统时间 + cal.add(Calendar.DAY_OF_YEAR, 1);//日期值加1 + isDateChanged = true;//日期变化标志置为true + } else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {// 在凌晨12时变化到前一天夜晚11时的时候 + cal.setTimeInMillis(mDate.getTimeInMillis());//设定日期 + cal.add(Calendar.DAY_OF_YEAR, -1);//日期值减1 + isDateChanged = true; + } + if (oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY || + oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {//对于12小时制，对am 和pm的操作 + mIsAm = !mIsAm;//上下午标志转换 + updateAmPmControl();//更新上下午标志 + } + } else { + if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {//对于24小时制时，晚上11点和12点交替时对日期的更改 + cal.setTimeInMillis(mDate.getTimeInMillis()); + cal.add(Calendar.DAY_OF_YEAR, 1);//日期值加1 + isDateChanged = true; + } else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) {//这里是对于12小时制时，凌晨11点和12点交替时对日期的更改 + cal.setTimeInMillis(mDate.getTimeInMillis()); + cal.add(Calendar.DAY_OF_YEAR, -1); + isDateChanged = true; + } + } + int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm ? 0 : HOURS_IN_HALF_DAY);//获取当前时间并转化为小时制 + mDate.set(Calendar.HOUR_OF_DAY, newHour); + onDateTimeChanged();//设置新的小时数 + if (isDateChanged) {//如果日期发生变化则设置新日期 + setCurrentYear(cal.get(Calendar.YEAR)); + setCurrentMonth(cal.get(Calendar.MONTH)); + setCurrentDay(cal.get(Calendar.DAY_OF_MONTH)); + } + } + }; + + private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() {//对分钟时间进行监听，并根据变化做出修改 + @Override + public void onValueChange(NumberPicker picker, int oldVal, int newVal) {//数值改变更新函数 + int minValue = mMinuteSpinner.getMinValue(); + int maxValue = mMinuteSpinner.getMaxValue(); + int offset = 0;//设置offset初始值为0 + if (oldVal == maxValue && newVal == minValue) {//分钟数从最大变到最小 + offset += 1;//加一 + } else if (oldVal == minValue && newVal == maxValue) {//分钟数从最小变到最大 + offset -= 1;//减一 + } + if (offset != 0) {//如果存在时间偏移量，对时间进行修改 + mDate.add(Calendar.HOUR_OF_DAY, offset);//修改小时数 + mHourSpinner.setValue(getCurrentHour());//获取当前时间来确定小时轮转数 + updateDateControl(); + int newHour = getCurrentHourOfDay();//得到现在的小时数，来决定是否修改am或是pm + if (newHour >= HOURS_IN_HALF_DAY) {//如果现在的时间大于或者等于12，就设置为pm + mIsAm = false; + updateAmPmControl(); + } else {//新时间在12点前为am + mIsAm = true; + updateAmPmControl(); + } + } + mDate.set(Calendar.MINUTE, newVal);//更新分钟数 + onDateTimeChanged();//监听时间变化 + } + }; + + private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() {//监听上下午变化的监听器 + @Override + public void onValueChange(NumberPicker picker, int oldVal, int newVal) {//监听am与pm变化 + mIsAm = !mIsAm; + if (mIsAm) {//下午变到上午，小时数减12 + mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY); + } else {//上午变到下午，小时数加12 + mDate.add(Calendar.HOUR_OF_DAY, HOURS_IN_HALF_DAY); + } + updateAmPmControl(); + onDateTimeChanged(); + } + }; + + public interface OnDateTimeChangedListener {//检测日期的变化 + void onDateTimeChanged(DateTimePicker view, int year, int month, + int dayOfMonth, int hourOfDay, int minute); + } + + public DateTimePicker(Context context) { + this(context, System.currentTimeMillis()); + }//访问数据库，获取系统时间 + + public DateTimePicker(Context context, long date) {//将获得的系统时间转化为我们需要的数据 + this(context, date, DateFormat.is24HourFormat(context)); + } + + public DateTimePicker(Context context, long date, boolean is24HourView) {//选择时间 + super(context); + mDate = Calendar.getInstance();//获取当前时间 + mInitialising = true;//初始化 + mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY; + inflate(context, R.layout.datetime_picker, this);//找出对话框的布局 + + mDateSpinner = (NumberPicker) findViewById(R.id.date);//找到对话框上其它布局 + mDateSpinner.setMinValue(DATE_SPINNER_MIN_VAL);//设置对话框上日期最小值 + mDateSpinner.setMaxValue(DATE_SPINNER_MAX_VAL);//设置对话框上日期最大值 + mDateSpinner.setOnValueChangedListener(mOnDateChangedListener); + + mHourSpinner = (NumberPicker) findViewById(R.id.hour);//显示设置小时的视图 + mHourSpinner.setOnValueChangedListener(mOnHourChangedListener); + mMinuteSpinner = (NumberPicker) findViewById(R.id.minute);//显示设置分钟的视图 + mMinuteSpinner.setMinValue(MINUT_SPINNER_MIN_VAL);//设置组件最小值属性为分钟最小值 + mMinuteSpinner.setMaxValue(MINUT_SPINNER_MAX_VAL); + mMinuteSpinner.setOnLongPressUpdateInterval(100);//设置监听长按时间间隔为100ms + mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener); + + String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings();//对24小时下的am与pm各属性值进行初始化 + mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm);//显示设置上下午的视图 + mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL);//设置组件最小值属性为上下午编码最小值 + mAmPmSpinner.setMaxValue(AMPM_SPINNER_MAX_VAL); + mAmPmSpinner.setDisplayedValues(stringsForAmPm);//设置显示上下午字符串的值 + mAmPmSpinner.setOnValueChangedListener(mOnAmPmChangedListener); + + // update controls to initial state + updateDateControl();//更新日期控制使其为初态 + updateHourControl();//更新小时控制使其为初态 + updateAmPmControl();//更新上下午控制使其为初态 + + set24HourView(is24HourView);//设置24小时制 + + // set to current time + setCurrentDate(date);//设置当前日期 + + setEnabled(isEnabled());//设置其使能值 + + // set the content descriptions + mInitialising = false;//表示初始化已经结束 + } + + @Override + public void setEnabled(boolean enabled) {//将转轮设置为使能状态 + if (mIsEnabled == enabled) {//如果已经在使能状态，则返回 + return; + } + super.setEnabled(enabled); + mDateSpinner.setEnabled(enabled);//分别对四个分部件设置使能 + mMinuteSpinner.setEnabled(enabled); + mHourSpinner.setEnabled(enabled); + mAmPmSpinner.setEnabled(enabled); + mIsEnabled = enabled;//修改使能标志变量 + } + + @Override + public boolean isEnabled() { + return mIsEnabled; + }//判断时间日期选择器是否处于使能状态 + + /** + * Get the current date in millis + * + * @return the current date in millis + */ + public long getCurrentDateInTimeMillis() { + return mDate.getTimeInMillis(); + }//得到当前的秒数 + + /** + * Set the current date + * + * @param date The current date in millis + */ + public void setCurrentDate(long date) {//设置当前的时间，参数是date + Calendar cal = Calendar.getInstance();//获取当前的时间 + cal.setTimeInMillis(date); + setCurrentDate(cal.get(Calendar.YEAR), cal.get(Calendar.MONTH), cal.get(Calendar.DAY_OF_MONTH), + cal.get(Calendar.HOUR_OF_DAY), cal.get(Calendar.MINUTE)); + }//设置当前日期 + + /** + * Set the current date + * + * @param year The current year + * @param month The current month + * @param dayOfMonth The current dayOfMonth + * @param hourOfDay The current hourOfDay + * @param minute The current minute + */ + public void setCurrentDate(int year, int month, + int dayOfMonth, int hourOfDay, int minute) {//设置当前的时间，参数是年月日、小时和分钟数 + setCurrentYear(year); + setCurrentMonth(month); + setCurrentDay(dayOfMonth); + setCurrentHour(hourOfDay); + setCurrentMinute(minute); + }//获取当前年、月、日、时、分、12/24表示、AM/PM表示并修改 + + /** + * Get current year + * + * @return The current year + */ + public int getCurrentYear() { + return mDate.get(Calendar.YEAR); + }//获取当前的年份 + + /** + * Set current year + * + * @param year The current year + */ + public void setCurrentYear(int year) {//设置当前年份 + if (!mInitialising && year == getCurrentYear()) {//如果当前的年份是正确的并且已经初始化了，那么不需要在来设置年份 + return; + } + mDate.set(Calendar.YEAR, year);//修改年份 + updateDateControl();//更新日期控制 + onDateTimeChanged();//监听时间日期的改变 + } + + /** + * Get current month in the year + * + * @return The current month in the year + */ + public int getCurrentMonth() { + return mDate.get(Calendar.MONTH); + }//获取当前月份 + + /** + * Set current month in the year + * + * @param month The month in the year + */ + public void setCurrentMonth(int month) {//设置当前月份 + if (!mInitialising && month == getCurrentMonth()) {//若输入月份等于当前月份则不做修改 + return; + } + mDate.set(Calendar.MONTH, month);//修改月份 + updateDateControl();//更新控制日期 + onDateTimeChanged(); + } + + /** + * Get current day of the month + * + * @return The day of the month + */ + public int getCurrentDay() { + return mDate.get(Calendar.DAY_OF_MONTH); + }//获取当前日期 + + /** + * Set current day of the month + * + * @param dayOfMonth The day of the month + */ + public void setCurrentDay(int dayOfMonth) {//设置当前日期 + if (!mInitialising && dayOfMonth == getCurrentDay()) {//若输入日期等于当前日期则不做修改 + return; + } + mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth);//修改日期 + updateDateControl(); + onDateTimeChanged(); + } + + /** + * Get current hour in 24 hour mode, in the range (0~23) + * @return The current hour in 24 hour mode + */ + public int getCurrentHourOfDay() { + return mDate.get(Calendar.HOUR_OF_DAY); + }//获取24小时下的小时数 + + private int getCurrentHour() {//获取当前小时数 + if (mIs24HourView){//24小时下 + return getCurrentHourOfDay();//返回24小时制的小时数 + } else {//返回12小时制的小时数 + int hour = getCurrentHourOfDay(); + if (hour > HOURS_IN_HALF_DAY) {//与之前标注一样 + return hour - HOURS_IN_HALF_DAY; + } else { + return hour == 0 ? HOURS_IN_HALF_DAY : hour; + } + } + } + + /** + * Set current hour in 24 hour mode, in the range (0~23) + * + * @param hourOfDay + */ + public void setCurrentHour(int hourOfDay) {//设置当前小时数 + if (!mInitialising && hourOfDay == getCurrentHourOfDay()) {//输入小时数等于当前小时数则不做修改 + return; + } + mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);//修改小时数 + if (!mIs24HourView) {//如果为12小时视图，则对小时数进行转化 + if (hourOfDay >= HOURS_IN_HALF_DAY) {//如果大于12点 + mIsAm = false;//pm + if (hourOfDay > HOURS_IN_HALF_DAY) {//晚上11点到第二天，更改小时数 + hourOfDay -= HOURS_IN_HALF_DAY; + } + } else { + mIsAm = true; + if (hourOfDay == 0) { + hourOfDay = HOURS_IN_HALF_DAY; + } + } + updateAmPmControl(); + } + mHourSpinner.setValue(hourOfDay); + onDateTimeChanged(); + } + + /** + * Get currentMinute + * + * @return The Current Minute + */ + public int getCurrentMinute() { + return mDate.get(Calendar.MINUTE); + }//获取当前分钟数 + + /** + * Set current minute + */ + public void setCurrentMinute(int minute) {//设置当前分钟数 + if (!mInitialising && minute == getCurrentMinute()) {//输入分钟数等于当前分钟数则不做修改 + return; + } + mMinuteSpinner.setValue(minute); + mDate.set(Calendar.MINUTE, minute);//修改分钟数 + onDateTimeChanged(); + } + + /** + * @return true if this is in 24 hour view else false. + */ + public boolean is24HourView () { + return mIs24HourView; + }//判断是否为24小时视图 + + /** + * Set whether in 24 hour or AM/PM mode. + * + * @param is24HourView True for 24 hour mode. False for AM/PM mode. + */ + public void set24HourView(boolean is24HourView) {//设置24小时视图 + if (mIs24HourView == is24HourView) { + return; + } + mIs24HourView = is24HourView; + mAmPmSpinner.setVisibility(is24HourView ? View.GONE : View.VISIBLE);//如果是12小时制则显示上午还是下午 + int hour = getCurrentHourOfDay();//定义hour为当前24小时下的小时数 + updateHourControl();//更新小时操作 + setCurrentHour(hour);//设置小时数 + updateAmPmControl();//更新am和pm操作 + } + + private void updateDateControl() {//更新日期控制 + Calendar cal = Calendar.getInstance();//获取当前日期实例 + cal.setTimeInMillis(mDate.getTimeInMillis()); + cal.add(Calendar.DAY_OF_YEAR, -DAYS_IN_ALL_WEEK / 2 - 1);//加一天 + mDateSpinner.setDisplayedValues(null); + for (int i = 0; i < DAYS_IN_ALL_WEEK; ++i) {//循环，当i小于一周的天数时 + cal.add(Calendar.DAY_OF_YEAR, 1);//加一 + mDateDisplayValues[i] = (String) DateFormat.format("MM.dd EEEE", cal);//日期显示形式 + } + mDateSpinner.setDisplayedValues(mDateDisplayValues); + mDateSpinner.setValue(DAYS_IN_ALL_WEEK / 2); + mDateSpinner.invalidate();//使日期转轮失效 + } + + private void updateAmPmControl() {//更新上下午的控制 + if (mIs24HourView) {//24小时视图下 + mAmPmSpinner.setVisibility(View.GONE);//使上下午转轮不可见 + } else { + int index = mIsAm ? Calendar.AM : Calendar.PM;//判断当前是上午还是下午 + mAmPmSpinner.setValue(index);//设置上下午转轮的值 + mAmPmSpinner.setVisibility(View.VISIBLE);//使上下午转轮可见 + } + } + + private void updateHourControl() {//更新小时控制 + if (mIs24HourView) {//根据当前小时制设置时间 + mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW);//设置最小轮转为24小时 + mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW);//设置最大轮转为24小时 + } else { + mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW);//设置最小轮转为12小时 + mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW);//设置最大轮转为12小时 + } + } + + /** + * Set the callback that indicates the 'Set' button has been pressed. + * @param callback the callback, if null will do nothing + */ + public void setOnDateTimeChangedListener(OnDateTimeChangedListener callback) {//根据参数设置时间日期监听器 + mOnDateTimeChangedListener = callback; + } + + private void onDateTimeChanged() {//监听日期时间变化 + if (mOnDateTimeChangedListener != null) {//输入年月日时分秒 + mOnDateTimeChangedListener.onDateTimeChanged(this, getCurrentYear(), + getCurrentMonth(), getCurrentDay(), getCurrentHourOfDay(), getCurrentMinute()); + } + } +} diff --git a/src/notes/ui/DateTimePickerDialog.java b/src/notes/ui/DateTimePickerDialog.java new file mode 100644 index 0000000..529d59e --- /dev/null +++ b/src/notes/ui/DateTimePickerDialog.java @@ -0,0 +1,90 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.ui;//引入ui包 + +import java.util.Calendar;//导入日历工具包 + +import net.micode.notes.R;//引入R包 +import net.micode.notes.ui.DateTimePicker; +import net.micode.notes.ui.DateTimePicker.OnDateTimeChangedListener;//日期选择器 + +import android.app.AlertDialog;//日期选择的对话框 +import android.content.Context; +import android.content.DialogInterface;//对话框界面 +import android.content.DialogInterface.OnClickListener;//点击监听器 +import android.text.format.DateFormat; +import android.text.format.DateUtils; + +public class DateTimePickerDialog extends AlertDialog implements OnClickListener {//时间日期选择器对话框 + + private Calendar mDate = Calendar.getInstance();//声明一个calendar类的对象，用于操作日期 + private boolean mIs24HourView;//判断当前设置是否为24小时模式 + private OnDateTimeSetListener mOnDateTimeSetListener;//声明一个日期设置监听控件 + private DateTimePicker mDateTimePicker;//声明日期选择器，运行时会产生数字的选择列表 + + public interface OnDateTimeSetListener {//设置一个接口当时期时间设置时进行的操作 + void OnDateTimeSet(AlertDialog dialog, long date);//设置时间监听器 + } + + public DateTimePickerDialog(Context context, long date) {//实例化数字选择器对话框 + super(context);//申请一个数字选择器 + mDateTimePicker = new DateTimePicker(context);//为数字选择器申请一个子视图 + setView(mDateTimePicker);//为日期时间选择器设置日期时间改变的监听器 + mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() {//设置时间改变监听器 + public void onDateTimeChanged(DateTimePicker view, int year, int month, + int dayOfMonth, int hourOfDay, int minute) {//将视图中的各选项设置为系统当前时间 + mDate.set(Calendar.YEAR, year);//将year设置为mNote的年份 + mDate.set(Calendar.MONTH, month);//修改月为系统月 + mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth);//修改月的天数为系统中月的天数 + mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);//修改一天中的小时为系统中的小时 + mDate.set(Calendar.MINUTE, minute);// 修改分钟为系统中的分钟 + updateTitle(mDate.getTimeInMillis());//更新对话框标题的时间 + } + }); + mDate.setTimeInMillis(date);//设置日期的毫秒级时间 + mDate.set(Calendar.SECOND, 0);//将秒数设置为0 + mDateTimePicker.setCurrentDate(mDate.getTimeInMillis());//根据从mdate中获取的当前时间设置现有时间 + setButton(context.getString(R.string.datetime_dialog_ok), this);//设置按钮 + setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null);//设置取消按钮 + set24HourView(DateFormat.is24HourFormat(this.getContext()));//设置为24小时显示 + updateTitle(mDate.getTimeInMillis());//更新标题时间 + } + + public void set24HourView(boolean is24HourView) { + mIs24HourView = is24HourView; + }//设置24小时视图 + + public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) {//设置一个时期时间设置的监听器 + mOnDateTimeSetListener = callBack;//回收日期监听器 + } + + private void updateTitle(long date) {//根据时间更新标题 + int flag =//通过DataUtils按照24时制显示 + DateUtils.FORMAT_SHOW_YEAR |//根据date和显示格式设置标题 + DateUtils.FORMAT_SHOW_DATE | + DateUtils.FORMAT_SHOW_TIME; + flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;//是否为24小时 + setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));//设置标题 + } + + public void onClick(DialogInterface arg0, int arg1) {//arg0接收到点击事件的对话框，arg1是该对话框上的按钮 + if (mOnDateTimeSetListener != null) {//设置日期时间 + mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis()); + } + } + +} \ No newline at end of file diff --git a/src/notes/ui/DropdownMenu.java b/src/notes/ui/DropdownMenu.java new file mode 100644 index 0000000..d983983 --- /dev/null +++ b/src/notes/ui/DropdownMenu.java @@ -0,0 +1,61 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.ui;//导入ui包 + +import android.content.Context;//引入需要使用的Context、Menu等包 +import android.view.Menu; +import android.view.MenuItem;//菜单条款 +import android.view.View; +import android.view.View.OnClickListener;//监听点击 +import android.widget.Button;//导入按钮工具 +import android.widget.PopupMenu;//弹出菜单 +import android.widget.PopupMenu.OnMenuItemClickListener;//菜单点击监听器 + +import net.micode.notes.R; + +public class DropdownMenu {//声明一个下拉菜单 + private Button mButton;//定义按钮控件 + private PopupMenu mPopupMenu;//定义弹出式菜单 + private Menu mMenu;//定义菜单 + + public DropdownMenu(Context context, Button button, int menuId) {//设置显示一个菜单 + mButton = button;//设置按钮样式 + mButton.setBackgroundResource(R.drawable.dropdown_icon);//设置其背景资源为下拉菜单的图标 + mPopupMenu = new PopupMenu(context, mButton);//实例化一个弹出式菜单 + mMenu = mPopupMenu.getMenu();//获得弹出式菜单的菜单项 + mPopupMenu.getMenuInflater().inflate(menuId, mMenu);//获得弹出式菜单的菜单项 + mButton.setOnClickListener(new OnClickListener() {//当我们点击mButton时，会弹出菜单 + public void onClick(View v) { + mPopupMenu.show(); + }//设点击显示菜单 + }); + } + + public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) {//置下拉菜单的点击监听方法 + if (mPopupMenu != null) { + mPopupMenu.setOnMenuItemClickListener(listener);//对非空的菜单的具体条目设置监听 + } + } + + public MenuItem findItem(int id) { + return mMenu.findItem(id); + }//对于菜单选项的初始化，根据索引搜索菜单需要的选项 + + public void setTitle(CharSequence title) { + mButton.setText(title); + }//根据索引搜索菜单需要的选项 +} diff --git a/src/notes/ui/FoldersListAdapter.java b/src/notes/ui/FoldersListAdapter.java new file mode 100644 index 0000000..eaab14f --- /dev/null +++ b/src/notes/ui/FoldersListAdapter.java @@ -0,0 +1,80 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.ui;//导入ui包 +//以下导入各种包 +import android.content.Context; +import android.database.Cursor;//光标 +import android.view.View; +import android.view.ViewGroup;//视图组 +import android.widget.CursorAdapter;//光标适配器 +import android.widget.LinearLayout; +import android.widget.TextView;//文本视图 + +import net.micode.notes.R; +import net.micode.notes.data.Notes; +import net.micode.notes.data.Notes.NoteColumns;//便签栏 + + +public class FoldersListAdapter extends CursorAdapter {//文件夹列表配适器，用于显示文件夹的列表 + public static final String [] PROJECTION = {//调用数据库中便签的ID和片段 + NoteColumns.ID, + NoteColumns.SNIPPET + }; + + public static final int ID_COLUMN = 0;//定义常量，文件夹ID栏编号 + public static final int NAME_COLUMN = 1;//初始化常量NAME + + public FoldersListAdapter(Context context, Cursor c) {//调用父类的构造函数 + super(context, c);//引用父类方法 + // TODO Auto-generated constructor stub + }//构造函数，调用父类的构造器，将c中的数据传输进该context + + @Override + public View newView(Context context, Cursor cursor, ViewGroup parent) {//创建一个文件夹并初始化子文件夹标签 + return new FolderListItem(context); + } + + @Override + public void bindView(View view, Context context, Cursor cursor) {//将各个布局文件绑定起来 + if (view instanceof FolderListItem) {//判断视图是否是文件夹列表的一项 + String folderName = (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context + .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);//移动对方的文件夹 + ((FolderListItem) view).bind(folderName);//绑定文件夹视图 + } + } + + public String getFolderName(Context context, int position) {//根据数据库中标签的ID得到标签的各项内容 + Cursor cursor = (Cursor) getItem(position);//获取当前游标 + return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context//返回当前文件夹的名字 + .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);//获取对方的文件夹 + } + + private class FolderListItem extends LinearLayout {//设置文件夹项目列表的名称 + private TextView mName; + + public FolderListItem(Context context) {//文件夹项的构造函数 + super(context);//操作数据库 + inflate(context, R.layout.folder_list_item, this);//根据布局文件的名字等信息将其找出来 + mName = (TextView) findViewById(R.id.tv_folder_name);//根据ID寻找文件的名字等信息 + } + + public void bind(String name) { + mName.setText(name); + }//绑定文件夹名称 + } + +} diff --git a/src/notes/ui/NoteEditActivity.java b/src/notes/ui/NoteEditActivity.java new file mode 100644 index 0000000..bab9e9f --- /dev/null +++ b/src/notes/ui/NoteEditActivity.java @@ -0,0 +1,873 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.ui;//导入ui包 + +import android.app.Activity; +import android.app.AlarmManager;//安卓系统应用开发 +import android.app.AlertDialog;// 闹钟管理器 +import android.app.PendingIntent; +import android.app.SearchManager;//搜索管理器 +import android.appwidget.AppWidgetManager;//App工具管理器 +import android.content.ContentUris;//内容 +import android.content.Context;//背景 +import android.content.DialogInterface;//对话框界面 +import android.content.Intent;//内容意图 +import android.content.SharedPreferences;//内容偏好共享 +import android.graphics.Paint;//引入绘画包 +import android.os.Bundle; +import android.preference.PreferenceManager;//偏好管理 +import android.text.Spannable;//可跨度文本 +import android.text.SpannableString; +import android.text.TextUtils;//文本单元 +import android.text.format.DateUtils;//日期形式 +import android.text.style.BackgroundColorSpan;//背景颜色风格 +import android.util.Log;//日志工具 +import android.view.LayoutInflater;//布局视图 +import android.view.Menu;//菜单视图 +import android.view.MenuItem;//菜单条款 +import android.view.MotionEvent;//动态事件 +import android.view.View; +import android.view.View.OnClickListener;//针对标签标记的设置，继承了许多有关监听的类 +import android.view.WindowManager;//窗口管理 +import android.widget.CheckBox; +import android.widget.CompoundButton;//合成按钮 +import android.widget.CompoundButton.OnCheckedChangeListener;//变化监听器 +import android.widget.EditText; +import android.widget.ImageView;//图像 +import android.widget.LinearLayout;//线性布局 +import android.widget.TextView;//文本视图 +import android.widget.Toast; + +import net.micode.notes.R; +import net.micode.notes.data.Notes;//便签数据 +import net.micode.notes.data.Notes.TextNote;//小米便签文本 +import net.micode.notes.model.WorkingNote;//便签运行模型 +import net.micode.notes.model.WorkingNote.NoteSettingChangedListener;//便签设置变化监听器 +import net.micode.notes.tool.DataUtils;//数据单元 +import net.micode.notes.tool.ResourceParser;//资源解析器 +import net.micode.notes.tool.ResourceParser.TextAppearanceResources;//文本资源显示 +import net.micode.notes.ui.DateTimePickerDialog.OnDateTimeSetListener;//日期设置监听器 +import net.micode.notes.ui.NoteEditText.OnTextViewChangeListener;//文本变化监听器 +import net.micode.notes.widget.NoteWidgetProvider_2x;//便签宽度为2X +import net.micode.notes.widget.NoteWidgetProvider_4x; + +import java.util.HashMap; +import java.util.HashSet; +import java.util.Map; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + + +public class NoteEditActivity extends Activity implements OnClickListener, + NoteSettingChangedListener, OnTextViewChangeListener {//继承Activity,实现了便签的编辑功能，同时对三个监听接口的方法进行实现 + private class HeadViewHolder {//创建一个类用于显示文本与图片 + public TextView tvModified;//当前文本视图 + + public ImageView ivAlertIcon;//提醒的图标 + + public TextView tvAlertDate;//设置的提醒的时间 + + public ImageView ibSetBgColor;//设置背景颜色 + } + + private static final Map sBgSelectorBtnsMap = new HashMap();//运用Hashmap类，将颜色按钮和对应的资源解析器中的相应颜色关联 + static {//对HashMap进行初始化，主要是颜色的对应 + sBgSelectorBtnsMap.put(R.id.iv_bg_yellow, ResourceParser.YELLOW);//黄 + sBgSelectorBtnsMap.put(R.id.iv_bg_red, ResourceParser.RED);//红 + sBgSelectorBtnsMap.put(R.id.iv_bg_blue, ResourceParser.BLUE);//蓝 + sBgSelectorBtnsMap.put(R.id.iv_bg_green, ResourceParser.GREEN);//绿 + sBgSelectorBtnsMap.put(R.id.iv_bg_white, ResourceParser.WHITE);//白 + }//各种颜色的对应 + + private static final Map sBgSelectorSelectionMap = new HashMap();//实现资源解析器中的颜色ID与背景颜色选择选择按钮（已选择）对应 + static { + sBgSelectorSelectionMap.put(ResourceParser.YELLOW, R.id.iv_bg_yellow_select);//将资源剖析器与选择器相连 + sBgSelectorSelectionMap.put(ResourceParser.RED, R.id.iv_bg_red_select); + sBgSelectorSelectionMap.put(ResourceParser.BLUE, R.id.iv_bg_blue_select); + sBgSelectorSelectionMap.put(ResourceParser.GREEN, R.id.iv_bg_green_select); + sBgSelectorSelectionMap.put(ResourceParser.WHITE, R.id.iv_bg_white_select); + }//提供了一个用户选择主界面颜色的功能 + + private static final Map sFontSizeBtnsMap = new HashMap();//将字体的大小与相对应的选择相连接 + static {//提供各种大小字体的选择 + sFontSizeBtnsMap.put(R.id.ll_font_large, ResourceParser.TEXT_LARGE);//大 + sFontSizeBtnsMap.put(R.id.ll_font_small, ResourceParser.TEXT_SMALL);//小 + sFontSizeBtnsMap.put(R.id.ll_font_normal, ResourceParser.TEXT_MEDIUM);//普通 + sFontSizeBtnsMap.put(R.id.ll_font_super, ResourceParser.TEXT_SUPER);//超大 + } + + private static final Map sFontSelectorSelectionMap = new HashMap();//实现资源解析器中字号ID与字体大小按钮（已选择）对应 + static {//选择字体大小的界面 + sFontSelectorSelectionMap.put(ResourceParser.TEXT_LARGE, R.id.iv_large_select); + sFontSelectorSelectionMap.put(ResourceParser.TEXT_SMALL, R.id.iv_small_select); + sFontSelectorSelectionMap.put(ResourceParser.TEXT_MEDIUM, R.id.iv_medium_select); + sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER, R.id.iv_super_select); + } + + private static final String TAG = "NoteEditActivity";//编辑文本的activity + + private HeadViewHolder mNoteHeaderHolder;//设置头部布局 + + private View mHeadViewPanel;//对表头的操作 + + private View mNoteBgColorSelector;//便签的背景色选择器 + + private View mFontSizeSelector;//便签的字体大小选择器 + + private EditText mNoteEditor;//便签编辑器 + + private View mNoteEditorPanel;//文本编辑控制板 + + private WorkingNote mWorkingNote;//对模板WorkingNote的初始化 + + private SharedPreferences mSharedPrefs;//私有化SharedPreferences的数据存储方式 + private int mFontSizeId;//操作字体大小 + + private static final String PREFERENCE_FONT_SIZE = "pref_font_size";//字体大小设置 + + private static final int SHORTCUT_ICON_TITLE_MAX_LEN = 10;//设置标题最大长度为10 + + public static final String TAG_CHECKED = String.valueOf('\u221A');//定义final字符串，表明已标记 + public static final String TAG_UNCHECKED = String.valueOf('\u25A1');//定义final字符串，表明未标记 + + private LinearLayout mEditTextList;//线性布局，用于编辑文本 + + private String mUserQuery;//用户请求 + private Pattern mPattern;//正则表达式模式 + + @Override + protected void onCreate(Bundle savedInstanceState) {//在界面创建时会调用的函数，用于在创建这样一个窗口时进行自定义操作 + super.onCreate(savedInstanceState);//调用父类的onCreate()方法 + this.setContentView(R.layout.note_edit);//设置活动的显示布局 + + if (savedInstanceState == null && !initActivityState(getIntent())) { + finish(); + return; + }//如果未保存实例状态且当前Activity未初始化完成，则结束当前Activity + initResources();//初始化资源 + } + + /** + * Current activity may be killed when the memory is low. Once it is killed, for another time + * user load this activity, we should restore the former state + */ + @Override + protected void onRestoreInstanceState(Bundle savedInstanceState) {//保存当前界面状态 + super.onRestoreInstanceState(savedInstanceState);//调用父类函数 + if (savedInstanceState != null && savedInstanceState.containsKey(Intent.EXTRA_UID)) {//如果保存了关闭前的实例状态且其中包含着便签标识符，则将该标识符添加到初始化Activity的Intent中 + Intent intent = new Intent(Intent.ACTION_VIEW);//新建一个intent + intent.putExtra(Intent.EXTRA_UID, savedInstanceState.getLong(Intent.EXTRA_UID));//利用此前的extra_uid初始化一个intent + if (!initActivityState(intent)) {//初始化活动状态失败，则结束Activity + finish(); + return; + } + Log.d(TAG, "Restoring from killed activity");//记录操作信息到日志中 + } + } + + private boolean initActivityState(Intent intent) {//初始化活动状态 + /** + * If the user specified the {@link Intent#ACTION_VIEW} but not provided with id, + * then jump to the NotesListActivity + *///如果找不到便签，则返回NotesListActivity，并报错“便签不存在”// + mWorkingNote = null;// 初始化便签数据 + if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) {//触摸动作的原始32位信息，包括事件的动作，触控点信息 + long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0);//获取到便签id + mUserQuery = "";// + + /** + * Starting from the searched result + */ + if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) {//若intent中含有搜索的数据 + noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY));//获取便签ID + mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY);//将用户请求的字符串保存在变量mUserQuery中 + } + + if (!DataUtils.visibleInNoteDatabase(getContentResolver(), noteId, Notes.TYPE_NOTE)) {//如果在数据库中查找不到 + Intent jump = new Intent(this, NotesListActivity.class);//设置Intent目的组件为NotesListActivity + startActivity(jump); + showToast(R.string.error_note_not_exist);//设置Intent目的组件为NotesListActivity + finish(); + return false; + } else { + mWorkingNote = WorkingNote.load(this, noteId);//加载对应id的便签项 + if (mWorkingNote == null) {//如果活动便签为空，显示错误信息 + Log.e(TAG, "load note failed with note id" + noteId);//导出信息失败 + finish(); + return false; + } + } + getWindow().setSoftInputMode(//设置软键盘输入模式 + WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN//将软键盘输入进行隐藏 + | WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE);//使Edit界面适应软键盘弹出 + } else if(TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT, intent.getAction())) {//通过 getAction得到的字符串，来决定做什么 + // New note + long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0);//获取intent中传入的父文件夹id，默认为0 + int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID, + AppWidgetManager.INVALID_APPWIDGET_ID);//获取布局文件id，默认返回参数为无效参数 + int widgetType = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, + Notes.TYPE_WIDGET_INVALIDE);//获取布局文件类型，默认为无效参数 + int bgResId = intent.getIntExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, + ResourceParser.getDefaultBgId(this));//获取背景颜色资源id，默认为随机背景色 + + // Parse call-record note + String phoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER);//解析电话簿记录 + long callDate = intent.getLongExtra(Notes.INTENT_EXTRA_CALL_DATE, 0);//获取提醒时间，默认为0 + if (callDate != 0 && phoneNumber != null) {//如果通话日期与号码均存在 + if (TextUtils.isEmpty(phoneNumber)) {//如果记录的通话号码为空，则显示警告 + Log.w(TAG, "The call record number is null"); + } + long noteId = 0;//这里根据获取到的电话号字符串从数据库中获取相应的noteid + if ((noteId = DataUtils.getNoteIdByPhoneNumberAndCallDate(getContentResolver(), + phoneNumber, callDate)) > 0) {//通过通话号码和通话日期在数据库中查找noteId + mWorkingNote = WorkingNote.load(this, noteId);//导入这个便签 + if (mWorkingNote == null) {//noteId对应的内容为空，输出报错信息，返回错误，初始化失败 + Log.e(TAG, "load call note failed with note id" + noteId); + finish(); + return false; + } + } else {//将电话号码与手机的号码簿相关 + mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, + widgetType, bgResId);//没有查找到noteId信息则重新建立空便签，使用之前默认参量对便签进行初始化 + mWorkingNote.convertToCallNote(phoneNumber, callDate);//将便签转化为通话记录便签 + } + } else {//将电话号码与手机的号码簿相关 + mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, widgetType, + bgResId);//创建一个空的便签来进行操作 + } + + getWindow().setSoftInputMode(//键盘输入设置 + WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE + | WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE); + } else { + Log.e(TAG, "Intent not specified action, should not support");//打印错误信息 + finish(); + return false; + } + mWorkingNote.setOnSettingStatusChangedListener(this);//为这个便签设置一个设置变化的监听器 + return true;//返回true表示初始化该Activity成功 + } + + @Override + protected void onResume() { + super.onResume();//进行重新返回的函数 + initNoteScreen();//初始化便签屏幕 + } + + private void initNoteScreen() {//对界面进行初始化的操作 + mNoteEditor.setTextAppearance(this, TextAppearanceResources + .getTexAppearanceResource(mFontSizeId));//根据字体大小设置便签编辑器的文本格式 + if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {//如果便签的模式为清单模式 + switchToListMode(mWorkingNote.getContent());//转移到列表的模式 + } else {//不为清单列表界面，继续执行 + mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery));//设置文本为高亮显示的搜索结果 + mNoteEditor.setSelection(mNoteEditor.getText().length());//设置文本编辑框中显示的文字是workingnote类中包含的便签文字，并且设置文本被选中 + } + for (Integer id : sBgSelectorSelectionMap.keySet()) {//对于背景里的图片选择做for循环遍历 + findViewById(sBgSelectorSelectionMap.get(id)).setVisibility(View.GONE);//将背景选择图片都设置为不显示 + } + mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId());//设置便签头部背景和编辑部分的背景颜色 + mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId());//为便签编辑器设置背景 + + mNoteHeaderHolder.tvModified.setText(DateUtils.formatDateTime(this,//设置标题中显示的文字包含其被编辑的日期信息 + mWorkingNote.getModifiedDate(), DateUtils.FORMAT_SHOW_DATE//在便签顶部显示时间 + | DateUtils.FORMAT_NUMERIC_DATE | DateUtils.FORMAT_SHOW_TIME + | DateUtils.FORMAT_SHOW_YEAR));//年份 + + /** + * TODO: Add the menu for setting alert. Currently disable it because the DateTimePicker + * is not ready + */ + showAlertHeader();//在标题头部设置提醒的时间 + } + + private void showAlertHeader() { + if (mWorkingNote.hasClockAlert()) {//如果当前便签已经设置了提醒，则继续向下判断 + long time = System.currentTimeMillis();//得到当前时间 + if (time > mWorkingNote.getAlertDate()) {//如果系统时间大于了闹钟设置的时间，那么闹钟失效 + mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired);//提醒时间已过期 + } else {//如果没超时，则显示还剩下多少时间 + mNoteHeaderHolder.tvAlertDate.setText(DateUtils.getRelativeTimeSpanString( + mWorkingNote.getAlertDate(), time, DateUtils.MINUTE_IN_MILLIS));//如果提醒时间未到，则设置标题中显示提醒时间 + } + mNoteHeaderHolder.tvAlertDate.setVisibility(View.VISIBLE);//显示闹钟开启的图标 + mNoteHeaderHolder.ivAlertIcon.setVisibility(View.VISIBLE);//提醒时间图标显示可见 + } else { +// mNoteHeaderHolder.tvAlertDate.setVisibility(View.GONE);//如果便签不包含提醒，则不显示 + mNoteHeaderHolder.ivAlertIcon.setVisibility(View.GONE); + }; + } + + @Override + protected void onNewIntent(Intent intent) {//新建一个传值对象 + super.onNewIntent(intent); + initActivityState(intent);//初始化活动状态 + } + + @Override + protected void onSaveInstanceState(Bundle outState) {//保存当前活动的状态 + super.onSaveInstanceState(outState); + /** + * For new note without note id, we should firstly save it to + * generate a id. If the editing note is not worth saving, there + * is no id which is equivalent to create new note + */ + if (!mWorkingNote.existInDatabase()) {//如果该workingnote实例无法在数据库中找到 + saveNote();//保存标签 + } + outState.putLong(Intent.EXTRA_UID, mWorkingNote.getNoteId());//将生成的noteId保存到outState中 + Log.d(TAG, "Save working note id: " + mWorkingNote.getNoteId() + " onSaveInstanceState");//使用Log输出debug信息，保存的执行便签id + } + + @Override + public boolean dispatchTouchEvent(MotionEvent ev) {//对屏幕触控事件的判断 + if (mNoteBgColorSelector.getVisibility() == View.VISIBLE + && !inRangeOfView(mNoteBgColorSelector, ev)) {//当备件颜色选择器可见，并且触控事件不在它的范围内时，执行下面代码 + mNoteBgColorSelector.setVisibility(View.GONE);//设置颜色选择器在屏幕上可见 + return true; + } + + if (mFontSizeSelector.getVisibility() == View.VISIBLE + && !inRangeOfView(mFontSizeSelector, ev)) {//当文字大小选择器可见，并且触控事件不在它的范围内时，执行下面代码 + mFontSizeSelector.setVisibility(View.GONE);//设置字体大小选择器在屏幕上可见 + return true; + } + return super.dispatchTouchEvent(ev);//未被消耗时调用父类的方法 + } + + private boolean inRangeOfView(View view, MotionEvent ev) {//判断触摸事件发生的位置是否在View控件范围内 + int []location = new int[2]; + view.getLocationOnScreen(location);//声明location数组，用于存放屏幕位置的横纵坐标x-y + int x = location[0]; + int y = location[1]; + if (ev.getX() < x//如果触控的位置超出了给定的范围，返回false + || ev.getX() > (x + view.getWidth()) + || ev.getY() < y + || ev.getY() > (y + view.getHeight())) { + return false; + } + return true; + } + + private void initResources() {//初始化资源 + mHeadViewPanel = findViewById(R.id.note_title);//初始化便签标题栏 + mNoteHeaderHolder = new HeadViewHolder();//HeadViewHolder是对便签顶部的视图的容器，此处实例化了它的对象 + mNoteHeaderHolder.tvModified = (TextView) findViewById(R.id.tv_modified_date);//建立便签的时候初始化时间 + mNoteHeaderHolder.ivAlertIcon = (ImageView) findViewById(R.id.iv_alert_icon);//得到提醒闹钟图标 + mNoteHeaderHolder.tvAlertDate = (TextView) findViewById(R.id.tv_alert_date);//得到闹钟日期 + mNoteHeaderHolder.ibSetBgColor = (ImageView) findViewById(R.id.btn_set_bg_color);//得到设置背景颜色的按钮 + mNoteHeaderHolder.ibSetBgColor.setOnClickListener(this);//设置背景颜色控件的点击监听 + mNoteEditor = (EditText) findViewById(R.id.note_edit_view);//初始化便签编辑部分界面 + mNoteEditorPanel = findViewById(R.id.sv_note_edit);//得到文件编辑器 + mNoteBgColorSelector = findViewById(R.id.note_bg_color_selector);//设置背景颜色的选择器 + for (int id : sBgSelectorBtnsMap.keySet()) {//对所有颜色选择按钮设置监听器 + ImageView iv = (ImageView) findViewById(id); + iv.setOnClickListener(this);//设置点击监听器 + } + + mFontSizeSelector = findViewById(R.id.font_size_selector);//初始化便签文字字号选择器 + for (int id : sFontSizeBtnsMap.keySet()) {//对所有字号选择按钮设置监听器 + View view = findViewById(id); + view.setOnClickListener(this); + }; + mSharedPrefs = PreferenceManager.getDefaultSharedPreferences(this);//得到用户的偏好信息 + mFontSizeId = mSharedPrefs.getInt(PREFERENCE_FONT_SIZE, ResourceParser.BG_DEFAULT_FONT_SIZE);//从偏好设置中得到设置字体大小的ID + /** + * HACKME: Fix bug of store the resource id in shared preference. + * The id may larger than the length of resources, in this case, + * return the {@link ResourceParser#BG_DEFAULT_FONT_SIZE} + */ + if(mFontSizeId >= TextAppearanceResources.getResourcesSize()) {//如果获取到的字体大小值的长度大于资源文件应有长度 + mFontSizeId = ResourceParser.BG_DEFAULT_FONT_SIZE;//将其设置为默认长度，缺省值为1 + } + mEditTextList = (LinearLayout) findViewById(R.id.note_edit_list);//得到标签编辑的列表 + } + + @Override + protected void onPause() {//重写onPause方法，将便签编辑界面暂停 + super.onPause(); + if(saveNote()) {//保存便签的内容 + Log.d(TAG, "Note data was saved with length:" + mWorkingNote.getContent().length());// 暂停时即进行便签的存储,记录log文件 + } + clearSettingState();//清除状态设置 + } + + private void updateWidget() {//更新窗口与桌面小窗口同步 + Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);//实例化Intent，用于和AppWidgetManager进行消息交换 + if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_2X) {//根据workingnote的widget类型大小，设置intent中映射的类 + intent.setClass(this, NoteWidgetProvider_2x.class); + } else if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_4X) {//如果是4倍大小 + intent.setClass(this, NoteWidgetProvider_4x.class); + } else { + Log.e(TAG, "Unspported widget type");//Log输出error信息，不支持的widget类型 + return; + } + + intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] {//将桌面挂件的标识作为附加信息添加到Intent中 + mWorkingNote.getWidgetId()//以广播形式发送intent + }); + + sendBroadcast(intent);//把intent信息广播发送 + setResult(RESULT_OK, intent);//设置当前Activity结束后将结束信息发送给其父活动 + } + + public void onClick(View v) {//当点击事件发生时执行该方法 + int id = v.getId();//获取到点击事件的id + if (id == R.id.btn_set_bg_color) {//如果点击的是设置背景颜色的按钮 + mNoteBgColorSelector.setVisibility(View.VISIBLE);//.背景颜色选择器设置为可见 + findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility( + View.VISIBLE);//将备选颜色界面设为可见 + } else if (sBgSelectorBtnsMap.containsKey(id)) {//判断是否是背景颜色选择器的一个按钮 + findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility( + View.GONE);//将原来的背影颜色设置为不可见 + mWorkingNote.setBgColorId(sBgSelectorBtnsMap.get(id));//根据id设置新的背景颜色 + mNoteBgColorSelector.setVisibility(View.GONE);//将背景颜色选择器隐藏 + } else if (sFontSizeBtnsMap.containsKey(id)) {//如果点击的是文字大小设置器中的文字大小选项按钮 + findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.GONE);//将备选字体界面设为可见 + mFontSizeId = sFontSizeBtnsMap.get(id);//获取字号 + mSharedPrefs.edit().putInt(PREFERENCE_FONT_SIZE, mFontSizeId).commit();//将共享设置中的字体进行修改 + findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);//将字体设置设为可见 + if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {//如果workingNote模式为核对列表模式 + getWorkingText();//.获取到正在编辑的文本 + switchToListMode(mWorkingNote.getContent());//将便签内容显示切换到列表模式 + } else { + mNoteEditor.setTextAppearance(this, + TextAppearanceResources.getTexAppearanceResource(mFontSizeId));//如果不是check模式，则设置文字编辑器中文字为相应字体大小 + } + mFontSizeSelector.setVisibility(View.GONE);//最后将文字大小选择器设置为不可见 + } + } + + @Override + public void onBackPressed() {//点击返回键时的操作 + if(clearSettingState()) {//如果无界面打开，则直接返回，否则关闭再返回 + return; + } + + saveNote();//保存便签 + super.onBackPressed(); + } + + private boolean clearSettingState() {//清除设置状态 + if (mNoteBgColorSelector.getVisibility() == View.VISIBLE) { + mNoteBgColorSelector.setVisibility(View.GONE);//如果背景色选择器可见，设置为不可见 + return true; + } else if (mFontSizeSelector.getVisibility() == View.VISIBLE) { + mFontSizeSelector.setVisibility(View.GONE);//如果文字大小选择器可见，则将其设置为不可见 + return true; + } + return false; + } + + public void onBackgroundColorChanged() {//背景颜色改变 + findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility( + View.VISIBLE);//通过workingnote对象中存储的背景色id，从预定义哈希表中找到对应项，设置为可见 + mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId());//根据workingNote的背景颜色资源id，设置便签编辑器的背景资源 + mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId());//将便签头的背景资源设置为标题的背景色 + } + + @Override + public boolean onPrepareOptionsMenu(Menu menu) {//对选择菜单的准备 + if (isFinishing()) {//如果窗口正在关闭，则不做处理 + return true; + } + clearSettingState();//清除设置状态 + menu.clear();//清除菜单项 + if (mWorkingNote.getFolderId() == Notes.ID_CALL_RECORD_FOLDER) {//如果便签所在的文件夹为便签的通话记录文件夹 + getMenuInflater().inflate(R.menu.call_note_edit, menu);//MenuInflater是用来实例化Menu目录下的Menu布局文件的 + } else { + getMenuInflater().inflate(R.menu.note_edit, menu);//加载一个布局文件 + } + if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {//是否进入了清单模式，加载相应的菜单 + menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_normal_mode);//将菜单中的菜单列表模式的标题设置为“离开选择列表” + } else { + menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_list_mode);//将菜单中的菜单列表模式的标题设置为“进入选择列表” + } + if (mWorkingNote.hasClockAlert()) {//如果便签有闹钟提醒 + menu.findItem(R.id.menu_alert).setVisible(false);//将添加提醒的菜单选项设置为不可见 + } else {//如果workingNote对象中没有时钟提醒事项，则把删除提醒的菜单选项设置为不可见 + menu.findItem(R.id.menu_delete_remind).setVisible(false); + } + return true; + } + + @Override + public boolean onOptionsItemSelected(MenuItem item) {//处理菜单被选中后的时间处理 + switch (item.getItemId()) {//获得项的id,根据菜单中不同的按钮设置不同的处理 + case R.id.menu_new_note://创建新标签 + createNewNote(); + break; + case R.id.menu_delete://删除便签 + AlertDialog.Builder builder = new AlertDialog.Builder(this);//实例化提醒对话框 + builder.setTitle(getString(R.string.alert_title_delete));//设置对话框的标题，“删除便签” + builder.setIcon(android.R.drawable.ic_dialog_alert);//设置对话框的图标 + builder.setMessage(getString(R.string.alert_message_delete_note));//设置对话框消息内容“确认删除这个便签？” + builder.setPositiveButton(android.R.string.ok, + new DialogInterface.OnClickListener() {//设置确认按钮，并监听它是否被点击 + public void onClick(DialogInterface dialog, int which) {//设置对话框的点击函数 + deleteCurrentNote();//删除当前的便签 + finish(); + } + }); + builder.setNegativeButton(android.R.string.cancel, null);//显示对话框.设置取消按钮 + builder.show();//显示提醒对话框 + break; + case R.id.menu_font_size://菜单字体大小的设置 + mFontSizeSelector.setVisibility(View.VISIBLE);//将字体的选择器置为可见 + findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);//通过id找到相应字体的大小 + break; + case R.id.menu_list_mode://列表的菜单模式 + mWorkingNote.setCheckListMode(mWorkingNote.getCheckListMode() == 0 ?//设置清单模式，若当前为清单模式，则取消；否之则设为清单模式 + TextNote.MODE_CHECK_LIST : 0); + break; + case R.id.menu_share://菜单共享 + getWorkingText();//获取当前便签的文本 + sendTo(this, mWorkingNote.getContent());//用sendto函数将运行文本发送到遍历的本文内 + break; + case R.id.menu_send_to_desktop://发送到桌面 + sendToDesktop(); + break; + case R.id.menu_alert://创建菜单的提醒设置 + setReminder();//删除菜单的提醒 + break; + case R.id.menu_delete_remind://选择删除提醒 + mWorkingNote.setAlertDate(0, false); + break; + default: + break; + } + return true; + } + + private void setReminder() {//建立事件提醒器 + DateTimePickerDialog d = new DateTimePickerDialog(this, System.currentTimeMillis());//建立修改时间日期的对话框 + d.setOnDateTimeSetListener(new OnDateTimeSetListener() {//置日期时间设定的监听器 + public void OnDateTimeSet(AlertDialog dialog, long date) {//设置日期提醒 + mWorkingNote.setAlertDate(date , true);//设置提醒时间 + } + }); + d.show();//显示该控件 + } + + /** + * Share note to apps that support {@link Intent#ACTION_SEND} action + * and {@text/plain} type + */ + private void sendTo(Context context, String info) {//该函数将字符串发送出去 + Intent intent = new Intent(Intent.ACTION_SEND);//新建发送活动的传值对象 + intent.putExtra(Intent.EXTRA_TEXT, info);//将需要传递的便签信息放入text文件中 + intent.setType("text/plain");//编辑连接器的类型 + context.startActivity(intent);//使用context启动intent对应的活动 + } + + private void createNewNote() {//创建新的便签 + // Firstly, save current editing notes + saveNote();//保存已有便签 + + // For safety, start a new NoteEditActivity + finish(); + Intent intent = new Intent(this, NoteEditActivity.class);//设置一个新的便签活动编辑器 + intent.setAction(Intent.ACTION_INSERT_OR_EDIT);//将当前活动设置为插入或者编辑 + intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mWorkingNote.getFolderId());//将运行便签的ID添加到Intent中 + startActivity(intent);//开始activity并链接 + } + + private void deleteCurrentNote() {//删除当前的便签 + if (mWorkingNote.existInDatabase()) {//判断便签是否在数据库中 + HashSet ids = new HashSet(); + long id = mWorkingNote.getNoteId();//获取当前便签的id + if (id != Notes.ID_ROOT_FOLDER) {//如果不是头文件夹建立一个hash表把便签id存起来 + ids.add(id); + } else {//否则输出错误 + Log.d(TAG, "Wrong note id, should not happen"); + } + if (!isSyncMode()) {//在非同步模式情况下 + if (!DataUtils.batchDeleteNotes(getContentResolver(), ids)) {//使用DataUtils的批量删除便签，将ids中的所有便签删除 + Log.e(TAG, "Delete Note error");//删除操作 + } + } else { + if (!DataUtils.batchMoveToFolder(getContentResolver(), ids, Notes.ID_TRASH_FOLER)) {//如果是同步模式，则将ids中的便签批量移动到“垃圾”文件夹。 + Log.e(TAG, "Move notes to trash folder error, should not happens");//输出错误信息 + } + } + } + mWorkingNote.markDeleted(true);//将该便签标记为已删除 + } + + private boolean isSyncMode() {//判断是否为同步模式 + return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;//返回同步的用户名长度，如果大于0则有同步状态，否则非同步 + } + + public void onClockAlertChanged(long date, boolean set) {//当提醒时间改变时执行该函数 + /** + * User could set clock to an unsaved note, so before setting the + * alert clock, we should save the note first + */ + if (!mWorkingNote.existInDatabase()) { + saveNote();//若当前编辑的便签不在数据库中，则先保存便签 + } + if (mWorkingNote.getNoteId() > 0) {//若当前编辑的便签的id>0 + Intent intent = new Intent(this, AlarmReceiver.class);//新建一个intent，指向活动AlarmReceiver + intent.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mWorkingNote.getNoteId()));//若有运行的便签就将便签的ID放置在URI中去 + PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 0, intent, 0);//设置延迟触发Intent + AlarmManager alarmManager = ((AlarmManager) getSystemService(ALARM_SERVICE));//获得闹钟服务 + showAlertHeader();//设置提醒管理器 + if(!set) { + alarmManager.cancel(pendingIntent);//如果没有确定设置提醒 ，则闹钟管理器取消该提醒 + } else { + alarmManager.set(AlarmManager.RTC_WAKEUP, date, pendingIntent);//将提醒时间、pendingintent传入闹钟管理器，作为新的提醒事项 + } + } else {//如果没有设置就报错 + /** + * There is the condition that user has input nothing (the note is + * not worthy saving), we have no note id, remind the user that he + * should input something + */ + Log.e(TAG, "Clock alert setting error");//如果便签id不存在，输出error信息 + showToast(R.string.error_note_empty_for_clock);//显示消息提示框，为未编辑的便签设置闹钟 + } + } + + public void onWidgetChanged() { + updateWidget(); + }//当widget变化时，执行更新widget这个函数 + + public void onEditTextDelete(int index, String text) {//删除编辑的文本框所出发的事件 + int childCount = mEditTextList.getChildCount();//获取EditText列表里EditText项的数量 + if (childCount == 1) { + return;//如果EditText项数为1，不做操作，返回 + } + + for (int i = index + 1; i < childCount; i++) {//修改删除文本之后的Index + ((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text))//通过id把编辑框存在便签编辑框中 + .setIndex(i - 1); + } + + mEditTextList.removeViewAt(index);//移除特定位置的视图 + NoteEditText edit = null; + if(index == 0) {////如果index为0，则将edit定位到第一个EditText项 + edit = (NoteEditText) mEditTextList.getChildAt(0).findViewById( + R.id.et_edit_text); + } else {//通过id把编辑框存在空的NoteEditText中 + edit = (NoteEditText) mEditTextList.getChildAt(index - 1).findViewById( + R.id.et_edit_text); + } + int length = edit.length();//获取edit的长度 + edit.append(text);//将后面的文本加入到edit中 + edit.requestFocus();//请求优先完成该此编辑 + edit.setSelection(length);//定位到length位置处的条目 + } + + public void onEditTextEnter(int index, String text) {//进入编辑文本框所触发的事件 + /** + * Should not happen, check for debug + */ + if(index > mEditTextList.getChildCount()) {//如果越界就报错 + Log.e(TAG, "Index out of mEditTextList boundrary, should not happen");//输出错误信息，“不可能发生” + } + + View view = getListItem(text, index);//根据文本和index获取到列表项的view + mEditTextList.addView(view, index);//添加当前项的视图 + NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);//建立一个新的视图并添加到编辑文本框内 + edit.requestFocus();//请求优先操作 + edit.setSelection(0);//设置选择地点 + for (int i = index + 1; i < mEditTextList.getChildCount(); i++) {//遍历子文本框并设置对应对下标 + ((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text)) + .setIndex(i); + } + } + + private void switchToListMode(String text) {//切换至列表模式 + mEditTextList.removeAllViews();//移除所有子视图 + String[] items = text.split("\n");//根据换行符分割字符串 + int index = 0;//清空所有视图，初始化下标 + for (String item : items) {//遍历所有文本单元并添加到文本列表中 + if(!TextUtils.isEmpty(item)) {//如果item不是空的 + mEditTextList.addView(getListItem(item, index));//添加新的视图 + index++; + } + } + mEditTextList.addView(getListItem("", index));//添加最后一行的相关标签 + mEditTextList.getChildAt(index).findViewById(R.id.et_edit_text).requestFocus();//获取当前列表项焦点 + + mNoteEditor.setVisibility(View.GONE);//便签编辑器不可见 + mEditTextList.setVisibility(View.VISIBLE);//将文本编辑框置为可见 + } + + private Spannable getHighlightQueryResult(String fullText, String userQuery) {//获取高亮效果的反馈情况 + SpannableString spannable = new SpannableString(fullText == null ? "" : fullText);//新建一个效果选项 + if (!TextUtils.isEmpty(userQuery)) {//如果搜索结果不为空 + mPattern = Pattern.compile(userQuery);//将用户的请求编译为正则表达式 + Matcher m = mPattern.matcher(fullText);//建立一个状态机检查pattern并进行匹配 + int start = 0;//初始化start + while (m.find(start)) {//将匹配到的内容设置为高亮 + spannable.setSpan(//设置背景颜色 + new BackgroundColorSpan(this.getResources().getColor(//将目标设置为高亮 + R.color.user_query_highlight)), m.start(), m.end(),//更新起始位置 + Spannable.SPAN_INCLUSIVE_EXCLUSIVE); + start = m.end(); + } + } + return spannable; + } + + private View getListItem(String item, int index) {//获取列表项 + View view = LayoutInflater.from(this).inflate(R.layout.note_edit_list_item, null);//获取便签编辑列表项的布局 + final NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);//获得编辑文本 + edit.setTextAppearance(this, TextAppearanceResources.getTexAppearanceResource(mFontSizeId));//创建一个文本编辑框并置为可见 + CheckBox cb = ((CheckBox) view.findViewById(R.id.cb_edit_item));//建立一个打钩框并设置监听器 + cb.setOnCheckedChangeListener(new OnCheckedChangeListener() {//设置监听判断是否已标识 + public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {//如果CheckBox已勾选 + if (isChecked) {//如果已经被标记 + edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG);//设置中划线 + } else {//未被标记 + edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG); + } + } + }); + + if (item.startsWith(TAG_CHECKED)) {//判断是否勾选 + cb.setChecked(true);//选择框设置为true + edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG); + item = item.substring(TAG_CHECKED.length(), item.length()).trim();//去掉TAG_CHECKED和空格 + } else if (item.startsWith(TAG_UNCHECKED)) {//选择不勾选 + cb.setChecked(false);//设置为false + edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG);//绘画 + item = item.substring(TAG_UNCHECKED.length(), item.length()).trim();//去掉unchecked与空格 + } + + edit.setOnTextViewChangeListener(this);//监听文本视图的变化 + edit.setIndex(index);//运行编辑框的监听器对该行为作出反应，并设置下标及文本内容 + edit.setText(getHighlightQueryResult(item, mUserQuery));//设置用户输入为高亮 + return view; + } + + public void onTextChange(int index, boolean hasText) {//便签内容发生改变 + if (index >= mEditTextList.getChildCount()) {//index超出EditText列表项数 + Log.e(TAG, "Wrong index, should not happen");//输出错误信息 + return; + } + if(hasText) {//内容不为空 + mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.VISIBLE);//将其子编辑框可见性置为可见 + } else {//否则不可见 + mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.GONE); + } + } + + public void onCheckListModeChanged(int oldMode, int newMode) {//检查模式和列表模式的切换 + if (newMode == TextNote.MODE_CHECK_LIST) {//如果新模式为列表模式 + switchToListMode(mNoteEditor.getText().toString());//检查模式切换到列表模式 + } else { + if (!getWorkingText()) {//如果未获取到workingText + mWorkingNote.setWorkingText(mWorkingNote.getContent().replace(TAG_UNCHECKED + " ", + ""));//设置工作文本 + } + mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery));//设置高亮文本 + mEditTextList.setVisibility(View.GONE);//便签文本列表设置为不可见 + mNoteEditor.setVisibility(View.VISIBLE);//便签编辑器设置为可见 + } + } + + private boolean getWorkingText() {//得到工作文本 + boolean hasChecked = false;//初始化check的标记 + if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {//判断是否是清单模式 + StringBuilder sb = new StringBuilder();//创建可变字符串 + for (int i = 0; i < mEditTextList.getChildCount(); i++) {//for循环遍历EditTextList的项 + View view = mEditTextList.getChildAt(i);//获取当前文本编辑列表的第i项 + NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);//获得文本编辑框 + if (!TextUtils.isEmpty(edit.getText())) {//若文本不为空 + if (((CheckBox) view.findViewById(R.id.cb_edit_item)).isChecked()) { + sb.append(TAG_CHECKED).append(" ").append(edit.getText()).append("\n");//扩展字符串为已打钩并把标记置true + hasChecked = true; + } else {//如果未被勾选 + sb.append(TAG_UNCHECKED).append(" ").append(edit.getText()).append("\n");//扩展字符串并且添加为未打勾 + } + } + } + mWorkingNote.setWorkingText(sb.toString());//利用编辑好的字符串设置运行便签的内容 + } else { + mWorkingNote.setWorkingText(mNoteEditor.getText().toString());//用编辑器中的内容设置运行中标签的内容 + } + return hasChecked;//返回便签是否已标记 + } + + private boolean saveNote() {//保存便签 + getWorkingText();//获取到当前编辑便签的文本 + boolean saved = mWorkingNote.saveNote();//获取工作文本后保存内容 + if (saved) {//如果已保存 + /** + * There are two modes from List view to edit view, open one note, + * create/edit a node. Opening node requires to the original + * position in the list when back from edit view, while creating a + * new node requires to the top of the list. This code + * {@link #RESULT_OK} is used to identify the create/edit state + */ + setResult(RESULT_OK);//代表是通过编辑的方式打开便签，而非新建便签 + } + return saved; + } + + private void sendToDesktop() {//将便签发送至桌面 + /** + * Before send message to home, we should make sure that current + * editing note is exists in databases. So, for new note, firstly + * save it + */ + if (!mWorkingNote.existInDatabase()) {//若便签不存在数据库中 + saveNote();//保存此新建的便签 + } + + if (mWorkingNote.getNoteId() > 0) {//若是有内容 + Intent sender = new Intent();//新建传递对象 + Intent shortcutIntent = new Intent(this, NoteEditActivity.class);//从当前活动跳转到编辑便签页面NoteEditActivity + shortcutIntent.setAction(Intent.ACTION_VIEW);//链接内容为一个视图 + shortcutIntent.putExtra(Intent.EXTRA_UID, mWorkingNote.getNoteId());//将便签的相关信息都添加到要发送的文件里 + sender.putExtra(Intent.EXTRA_SHORTCUT_INTENT, shortcutIntent);//将shortcut的图标标题存入sender中 + sender.putExtra(Intent.EXTRA_SHORTCUT_NAME, + makeShortcutIconTitle(mWorkingNote.getContent()));//设置图标 + sender.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, + Intent.ShortcutIconResource.fromContext(this, R.drawable.icon_app));//将便签的相关信息都添加到要发送的文件里 + sender.putExtra("duplicate", true); + sender.setAction("com.android.launcher.action.INSTALL_SHORTCUT");//设置sneder的行为是发送 + showToast(R.string.info_note_enter_desktop);//显示消息提示框，表示文本已经增加到home中 + sendBroadcast(sender);//显示到桌面 + } else {//如果便签的id错误，则保存提醒用户 + /** + * There is the condition that user has input nothing (the note is + * not worthy saving), we have no note id, remind the user that he + * should input something + */ + Log.e(TAG, "Send to desktop error");//空便签直接报错 + showToast(R.string.error_note_empty_for_send_to_desktop);//展示toast报错消息，提示不能发送一个空便签到桌面 + } + } + + private String makeShortcutIconTitle(String content) {//生成快捷方式的图标标题 + content = content.replace(TAG_CHECKED, "");//编辑小图标的标题 + content = content.replace(TAG_UNCHECKED, ""); + return content.length() > SHORTCUT_ICON_TITLE_MAX_LEN ? content.substring(0, + SHORTCUT_ICON_TITLE_MAX_LEN) : content;//直接设置为content中的内容并返回，有勾选和未勾选2种 + } + + private void showToast(int resId) { + showToast(resId, Toast.LENGTH_SHORT); + }//显示提示的视图 + + private void showToast(int resId, int duration) {//持续显示提示的视图 + Toast.makeText(this, resId, duration).show();//设置toast消息的文本内容 + } +} diff --git a/src/notes/ui/NoteEditText.java b/src/notes/ui/NoteEditText.java new file mode 100644 index 0000000..09e3987 --- /dev/null +++ b/src/notes/ui/NoteEditText.java @@ -0,0 +1,216 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.ui;//导入ui包 + +import android.content.Context;//环境内容 +import android.graphics.Rect;//图形 +import android.text.Layout;//文本布局 +import android.text.Selection;//文本选择 +import android.text.Spanned; +import android.text.TextUtils;//文本单元 +import android.text.style.URLSpan;//URL格式 +import android.util.AttributeSet;// 属性，特征 +import android.util.Log;//日志 +import android.view.ContextMenu;//菜单内容视图 +import android.view.KeyEvent;//关键事件 +import android.view.MenuItem;//菜单选项 +import android.view.MenuItem.OnMenuItemClickListener;//菜单点击监听器 +import android.view.MotionEvent;//动作事件 +import android.widget.EditText;//编辑文本 + +import net.micode.notes.R; + +import java.util.HashMap; +import java.util.Map; + +public class NoteEditText extends EditText {//继承edittext，设置便签设置文本框 + private static final String TAG = "NoteEditText";//标志为字符串"NoteEditText" + private int mIndex;//建立字符，整型的HASH表，用于进行电话、网站、邮箱的链接 + private int mSelectionStartBeforeDelete;//声明整型变量，获取删除文本前的位置 + + private static final String SCHEME_TEL = "tel:" ;//文本中电话号码内容 + private static final String SCHEME_HTTP = "http:" ;//文本中网页内容 + private static final String SCHEME_EMAIL = "mailto:" ;//文本中邮件内容 + + private static final Map sSchemaActionResMap = new HashMap();//设置映射，将文本内容（电话、网址、邮件）做链接处理 + static {//在NoteEditActivity中删除或增添文本的操作 + sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel); + sSchemaActionResMap.put(SCHEME_HTTP, R.string.note_link_web); + sSchemaActionResMap.put(SCHEME_EMAIL, R.string.note_link_email); + } + + /** + * Call by the {@link NoteEditActivity} to delete or add edit text + */ + public interface OnTextViewChangeListener {//实现对TextView组件中的文字信息进行修改 + /** + * Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens + * and the text is null + */ + void onEditTextDelete(int index, String text);//当触发删除文本KeyEvent时删除文本 + + /** + * Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER} + * happen + */ + void onEditTextEnter(int index, String text);//处理进入按键时的操作 + + /** + * Hide or show item option when text change + */ + void onTextChange(int index, boolean hasText);//文字更改时隐藏或显示项目选项 + } + + private OnTextViewChangeListener mOnTextViewChangeListener;//声明文本视图变化监听器 + + public NoteEditText(Context context) {//根据context设置文本 + super(context, null);//用super引用父类变量 + mIndex = 0;//设置当前光标 + } + + public void setIndex(int index) { + mIndex = index; + }//初始化文本修改标记 + + public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {//设置一个文本改变的监听器 + mOnTextViewChangeListener = listener;//设置文本视图变化监听器 + } + + public NoteEditText(Context context, AttributeSet attrs) {//初始化便签 + super(context, attrs, android.R.attr.editTextStyle);//第三个参数就是xml文件的资源，编辑风格 + } + public NoteEditText(Context context, AttributeSet attrs, int defStyle) {//根据defstyle自动初始化 + super(context, attrs, defStyle); + // TODO Auto-generated constructor stub + } + + @Override + public boolean onTouchEvent(MotionEvent event) {//处理手机屏幕的所有事件 + switch (event.getAction()) {//重写屏幕触发事件 + case MotionEvent.ACTION_DOWN://更新坐标 + + int x = (int) event.getX();//更新当前坐标值 + int y = (int) event.getY(); + x -= getTotalPaddingLeft();//减去左边控件的距离 + y -= getTotalPaddingTop();//减去上方控件的距离 + x += getScrollX();//加上滚轮滚过的距离 + y += getScrollY(); + + Layout layout = getLayout();//layout布局控件，设置新的位置 + int line = layout.getLineForVertical(y);//获取纵向的行数 + int off = layout.getOffsetForHorizontal(line, x);//获得横向的偏移量 + Selection.setSelection(getText(), off);//定位光标的位置 + break; + } + + return super.onTouchEvent(event);//继续调用父类的监听事件方法 + } + + @Override + public boolean onKeyDown(int keyCode, KeyEvent event) {//处理用户按下一个键盘按键时会触发的事件 + switch (keyCode) {//根据按键的KeyCode来处理 + case KeyEvent.KEYCODE_ENTER://根据按键的 Unicode 编码值来处理 + if (mOnTextViewChangeListener != null) {//进入键 + return false;//返回false + } + break; + case KeyEvent.KEYCODE_DEL://按下删除时设置了光标位置 + mSelectionStartBeforeDelete = getSelectionStart();//获取删除文本的开始位置 + break; + default://其他情况,我们返回父类的onKeyDown值 + break; + } + return super.onKeyDown(keyCode, event);//父类其他键盘事件 + } + + @Override + public boolean onKeyUp(int keyCode, KeyEvent event) {//当用户松开按键瞬间系统的响应 + switch(keyCode) {//据按键的 Unicode 编码值来处理，有删除和进入2种操作根 + case KeyEvent.KEYCODE_DEL://抬起删除键 + if (mOnTextViewChangeListener != null) {//如果文本视图发生变化 + if (0 == mSelectionStartBeforeDelete && mIndex != 0) {//如果文本视图发生变化 + mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString());//监听文本的删除 + return true; + } + } else { + Log.d(TAG, "OnTextViewChangeListener was not seted");//其他情况报错，文档的改动监听器并没有建立 + } + break; + case KeyEvent.KEYCODE_ENTER://抬起回车键 + if (mOnTextViewChangeListener != null) {//如果文本视图发生变化 + int selectionStart = getSelectionStart();//获取当前位置 + String text = getText().subSequence(selectionStart, length()).toString();//获取当前文本 + setText(getText().subSequence(0, selectionStart));//根据获取的文本设置当前文本 + mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text);//将选择区域内的文字移到下一行 + } else { + Log.d(TAG, "OnTextViewChangeListener was not seted");//其他情况报错，文档的改动监听器并没有建立 + } + break; + default: + break; + } + return super.onKeyUp(keyCode, event);//继续执行父类的其他按键弹起的事件 + } + + @Override + protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {//规定了编辑文本焦点改变时的系统响应 + if (mOnTextViewChangeListener != null) {//若监听器已经建立 + if (!focused && TextUtils.isEmpty(getText())) {//获取焦点文本不为空 + mOnTextViewChangeListener.onTextChange(mIndex, false);//置false隐藏事件选项 + } else { + mOnTextViewChangeListener.onTextChange(mIndex, true);//置true显示事件选项 + } + } + super.onFocusChanged(focused, direction, previouslyFocusedRect);//置true显示事件选项 + } + + @Override + protected void onCreateContextMenu(ContextMenu menu) {//定义了新建文本菜单的过程 + if (getText() instanceof Spanned) {//有文本存在 + int selStart = getSelectionStart();//获取文本开始结尾位置 + int selEnd = getSelectionEnd();//获取文本开始和结尾位置 + + int min = Math.min(selStart, selEnd);//获取开始到结尾的最小值 + int max = Math.max(selStart, selEnd);//开始到结尾的最大值 + + final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class);//设置url的信息的范围值 + if (urls.length == 1) {//设置url的信息的范围值 + int defaultResId = 0;//默认的资源ID值为0 + for(String schema: sSchemaActionResMap.keySet()) {//获取计划表中所有的key值 + if(urls[0].getURL().indexOf(schema) >= 0) {//若url可以添加则在添加后将defaultResId置为key所映射的值 + defaultResId = sSchemaActionResMap.get(schema);//若url可以添加则在添加后将defaultResId置为key所映射的值 + break; + } + } + + if (defaultResId == 0) {//defaultResId == 0则说明url并没有添加任何东西，所以置为打开map的值 + defaultResId = R.string.note_link_other; + } + + menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener(//建立菜单 + new OnMenuItemClickListener() {//实例化菜单监听器 + public boolean onMenuItemClick(MenuItem item) { + // goto a new intent + urls[0].onClick(NoteEditText.this);//根据相应的文本设置菜单的按键 + return true; + } + }); + } + } + super.onCreateContextMenu(menu);//创建文本菜单 + } +} diff --git a/src/notes/ui/NoteItemData.java b/src/notes/ui/NoteItemData.java new file mode 100644 index 0000000..ec56724 --- /dev/null +++ b/src/notes/ui/NoteItemData.java @@ -0,0 +1,224 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.ui; + +import android.content.Context; +import android.database.Cursor; +import android.text.TextUtils; + +import net.micode.notes.data.Contact; +import net.micode.notes.data.Notes; +import net.micode.notes.data.Notes.NoteColumns; +import net.micode.notes.tool.DataUtils; + + +public class NoteItemData {//常量标记和数据 + static final String [] PROJECTION = new String [] {//PROJECTION的字符串，记录基本元素 + NoteColumns.ID,//每个便签的序号ID + NoteColumns.ALERTED_DATE,//设置的警报提醒时间 + NoteColumns.BG_COLOR_ID,//背景颜色的id + NoteColumns.CREATED_DATE,//创建的时间 + NoteColumns.HAS_ATTACHMENT,// 标记：是否含有附件 + NoteColumns.MODIFIED_DATE,//修改日期 + NoteColumns.NOTES_COUNT,//便签数量 + NoteColumns.PARENT_ID,//父id + NoteColumns.SNIPPET,//文件夹名称或者文本注释内容 + NoteColumns.TYPE,//某一列note的种类，是text note还是folder + NoteColumns.WIDGET_ID,//挂件id + NoteColumns.WIDGET_TYPE, + }; + + private static final int ID_COLUMN = 0;//声明类属性，包括背景颜色、手机号码等 + private static final int ALERTED_DATE_COLUMN = 1; + private static final int BG_COLOR_ID_COLUMN = 2; + private static final int CREATED_DATE_COLUMN = 3; + private static final int HAS_ATTACHMENT_COLUMN = 4; + private static final int MODIFIED_DATE_COLUMN = 5; + private static final int NOTES_COUNT_COLUMN = 6; + private static final int PARENT_ID_COLUMN = 7; + private static final int SNIPPET_COLUMN = 8; + private static final int TYPE_COLUMN = 9; + private static final int WIDGET_ID_COLUMN = 10; + private static final int WIDGET_TYPE_COLUMN = 11; + + private long mId;//PROJECT的字符串名称对应的值 + private long mAlertDate; + private int mBgColorId; + private long mCreatedDate; + private boolean mHasAttachment; + private long mModifiedDate; + private int mNotesCount; + private long mParentId;//对方的id + private String mSnippet; + private int mType; + private int mWidgetId;//宽度 + private int mWidgetType;//宽度形式 + private String mName; + private String mPhoneNumber; + + private boolean mIsLastItem;//布尔类型，判断是否为最后一项 + private boolean mIsFirstItem;//判断是否为最开始的项 + private boolean mIsOnlyOneItem;//判断是否只有一个便签，或者一个文件夹 + private boolean mIsOneNoteFollowingFolder;//判断文件夹下是否只有一个便签 + private boolean mIsMultiNotesFollowingFolder;//判断文件夹下是否有多个便签 + + public NoteItemData(Context context, Cursor cursor) {//初始化NoteItemData，主要利用光标cursor获取的东西 + mId = cursor.getLong(ID_COLUMN);//从cursor中获取数据 + mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN); + mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN); + mCreatedDate = cursor.getLong(CREATED_DATE_COLUMN); + mHasAttachment = (cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0) ? true : false;//判断行列 + mModifiedDate = cursor.getLong(MODIFIED_DATE_COLUMN); + mNotesCount = cursor.getInt(NOTES_COUNT_COLUMN); + mParentId = cursor.getLong(PARENT_ID_COLUMN); + mSnippet = cursor.getString(SNIPPET_COLUMN);//获得字符串 + mSnippet = mSnippet.replace(NoteEditActivity.TAG_CHECKED, "").replace(//把每项前的方框符号和✔符号去掉 + NoteEditActivity.TAG_UNCHECKED, ""); + mType = cursor.getInt(TYPE_COLUMN); + mWidgetId = cursor.getInt(WIDGET_ID_COLUMN); + mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN); + + mPhoneNumber = "";//初始化电话号码的信息 + if (mParentId == Notes.ID_CALL_RECORD_FOLDER) {//通过id确定电话号码 + mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId);//使用DataUtils类中定义的函数获取电话号码信息 + if (!TextUtils.isEmpty(mPhoneNumber)) {//mphonenumber里有符合字符串，则用contart功能连接 + mName = Contact.getContact(context, mPhoneNumber);//通过这个phonenumber，调用getContact，利用键值对获取对应的name + if (mName == null) { + mName = mPhoneNumber;//如果匹配失败，就把phonenumber设置为name + } + } + } + + if (mName == null) {//如果没有对name复制成功，则把name设置为空值 + mName = ""; + } + checkPostion(cursor);//检查光标位置 + } + + private void checkPostion(Cursor cursor) {//通过光标所处位置设置标记 + mIsLastItem = cursor.isLast() ? true : false;//分别为各种描述状态的变量进行赋值 + mIsFirstItem = cursor.isFirst() ? true : false; + mIsOnlyOneItem = (cursor.getCount() == 1); + mIsMultiNotesFollowingFolder = false;//初始化“多重子文件”“单一子文件”2个标记 + mIsOneNoteFollowingFolder = false; + + if (mType == Notes.TYPE_NOTE && !mIsFirstItem) {//是NOTE格式且不是第一个item + int position = cursor.getPosition();//光标指向的位置 + if (cursor.moveToPrevious()) {//获取光标位置并看向上一行 + if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER//若光标满足SYSTEM或FOLDER格式 + || cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) {//数据行数大于当前位置+1则设置是多重子文件 + if (cursor.getCount() > (position + 1)) {//数据行数大于当前位置+1则设置是多重子文件 + mIsMultiNotesFollowingFolder = true;//设置为多重便签 + } else {//.否则为单一子文件 + mIsOneNoteFollowingFolder = true; + } + } + if (!cursor.moveToNext()) {//若光标不能重新向下走则报错 + throw new IllegalStateException("cursor move to previous but can't move back"); + } + } + } + } +//下面的代码的作用均是声明获取属性的方法 + public boolean isOneFollowingFolder() { + return mIsOneNoteFollowingFolder; + }//获取标记一些方法 + + public boolean isMultiFollowingFolder() { + return mIsMultiNotesFollowingFolder; + }//若父id为保存至文件夹模式的id且电话号码不空，则返回真 + + public boolean isLast() { + return mIsLastItem; + }//判断是否是最后一个项 + + public String getCallName() { + return mName; + }//获取便签名称 + + public boolean isFirst() { + return mIsFirstItem; + }//判断是否是第一个项 + + public boolean isSingle() { + return mIsOnlyOneItem; + }//判断是否只有一个项 + + public long getId() { + return mId; + }//获得对应的ID值 + + public long getAlertDate() { + return mAlertDate; + }//获得对应的提醒时间 + + public long getCreatedDate() { + return mCreatedDate; + }//获得创建时间 + + public boolean hasAttachment() { + return mHasAttachment; + }//判断是否关联桌面挂件 + + public long getModifiedDate() { + return mModifiedDate; + }//获得修改的时间 + + public int getBgColorId() { + return mBgColorId; + }//获取背景颜色 + + public long getParentId() { + return mParentId; + }//获得父进程的id + + public int getNotesCount() { + return mNotesCount; + }//获得便签数量 + + public long getFolderId () { + return mParentId; + }//获得文件夹id + + public int getType() { + return mType; + }//获得项的类型 + + public int getWidgetType() { + return mWidgetType; + }//获得桌面挂件的类型 + + public int getWidgetId() { + return mWidgetId; + }//获取挂件id + + public String getSnippet() { + return mSnippet; + }//获得文件夹名称 + + public boolean hasAlert() { + return (mAlertDate > 0); + }//判读此便签是否有提醒 + + public boolean isCallRecord() {//判断便签项是否为CallRecord + return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber));// 如果父类id保存至文件夹模式并且电话号码单元不为空 + } + + public static int getNoteType(Cursor cursor) { + return cursor.getInt(TYPE_COLUMN); + }//获得便签的类型 +} diff --git a/src/notes/ui/NotesListActivity.java b/src/notes/ui/NotesListActivity.java new file mode 100644 index 0000000..7693fa5 --- /dev/null +++ b/src/notes/ui/NotesListActivity.java @@ -0,0 +1,955 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +//引入工具包，类 +package net.micode.notes.ui;//这个类包含在net.micode.notes.ui这个包里 + +import android.app.Activity;//引入了一系列实现这个类功能所必须的类 +import android.app.AlertDialog; +import android.app.Dialog; +import android.appwidget.AppWidgetManager;//APP的界宽 +import android.content.AsyncQueryHandler; +import android.content.ContentResolver; +import android.content.ContentValues; +import android.content.Context;//文本 +import android.content.DialogInterface; +import android.content.Intent; +import android.content.SharedPreferences; +import android.database.Cursor;//光标 +import android.os.AsyncTask; +import android.os.Bundle; +import android.preference.PreferenceManager; +import android.text.Editable; +import android.text.TextUtils; +import android.text.TextWatcher;//文本观察器 +import android.util.Log; +import android.view.ActionMode; +import android.view.ContextMenu; +import android.view.ContextMenu.ContextMenuInfo;//文本菜单 +import android.view.Display; +import android.view.HapticFeedbackConstants; +import android.view.LayoutInflater; +import android.view.Menu; +import android.view.MenuItem; +import android.view.MenuItem.OnMenuItemClickListener;//菜单条款 +import android.view.MotionEvent; +import android.view.View; +import android.view.View.OnClickListener;//主界面，一进入就是这个界面 +import android.view.View.OnCreateContextMenuListener; +import android.view.View.OnTouchListener; +import android.view.inputmethod.InputMethodManager;//输入方法 +import android.widget.AdapterView; +import android.widget.AdapterView.OnItemClickListener; +import android.widget.AdapterView.OnItemLongClickListener;//点击监听 +import android.widget.Button; +import android.widget.EditText; +import android.widget.ListView; +import android.widget.PopupMenu; +import android.widget.TextView;//文本视图 +import android.widget.Toast; + +import net.micode.notes.R;//Android自动生成的R类，在该类中根据不同的资源类型又生成了相应的内部类，该类包含了系统中使用到的所有资源文件的标示。 +import net.micode.notes.data.Notes; +import net.micode.notes.data.Notes.NoteColumns; +import net.micode.notes.gtask.remote.GTaskSyncService;//远程 +import net.micode.notes.model.WorkingNote; +import net.micode.notes.tool.BackupUtils; +import net.micode.notes.tool.DataUtils; +import net.micode.notes.tool.ResourceParser; +import net.micode.notes.ui.NotesListAdapter.AppWidgetAttribute; +import net.micode.notes.widget.NoteWidgetProvider_2x; +import net.micode.notes.widget.NoteWidgetProvider_4x; + +import java.io.BufferedReader; +import java.io.IOException;//输入板块 +import java.io.InputStream; +import java.io.InputStreamReader; +import java.util.HashSet;//引入了一系列实现这个类功能所必须的类 +//小米便签主页面 +public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener {//这个类继承于Activity类，实现了两个接口，分别是点击监听器，和长按监听器，即在这个类的界面实现对这两种操作的响应，这是整个project的主类 + private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0;//声明并赋值一些不可更改的私有属性 + + private static final int FOLDER_LIST_QUERY_TOKEN = 1;//查询记号，同上，文件夹请求时使用（如：长按便签然后点移动到文件夹调用） + + private static final int MENU_FOLDER_DELETE = 0;//删除菜单文件 + + private static final int MENU_FOLDER_VIEW = 1;//菜单中的查看文件夹对应的int值 + + private static final int MENU_FOLDER_CHANGE_NAME = 2;//.菜单中改文件夹名项对应的int值 + + private static final String PREFERENCE_ADD_INTRODUCTION = "net.micode.notes.introduction";//用于第一次打开小米便签的判断 + + private enum ListEditState {//列表编辑状态类 + NOTE_LIST, SUB_FOLDER, CALL_RECORD_FOLDER + }; + + private ListEditState mState;//利用其它类声明一些私有对象 + + private BackgroundQueryHandler mBackgroundQueryHandler;//后台疑问处理 + + private NotesListAdapter mNotesListAdapter;//便签列表配适器 + + private ListView mNotesListView;//主界面的视图 + + private Button mAddNewNote;//最下方添加便签的按钮 + + private boolean mDispatch;//是否调度的判断变量 + + private int mOriginY;//首次触摸时屏幕上的垂直距离（y值） + + private int mDispatchY;//重新调度时的触摸的在屏幕上的垂直距离 + + private TextView mTitleBar;//子文件夹下的 标头 + + private long mCurrentFolderId;//当前文件夹的ID + + private ContentResolver mContentResolver;//提供内容分析 + + private ModeCallback mModeCallBack;//返回调用方法 + + private static final String TAG = "NotesListActivity";//名称（可用于日志文件调试） + + public static final int NOTES_LISTVIEW_SCROLL_RATE = 30;//列表滚动速度 + + private NoteItemData mFocusNoteDataItem;//光标指向的物件的数据内容 + + private static final String NORMAL_SELECTION = NoteColumns.PARENT_ID + "=?";//定义私有字符串变量 + + private static final String ROOT_FOLDER_SELECTION = "(" + NoteColumns.TYPE + "<>"//用于表明处于父文件夹下（主列表） + + Notes.TYPE_SYSTEM + " AND " + NoteColumns.PARENT_ID + "=?)" + " OR (" + + NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER + " AND " + + NoteColumns.NOTES_COUNT + ">0)"; + + private final static int REQUEST_CODE_OPEN_NODE = 102;//请求代码开放节点 + private final static int REQUEST_CODE_NEW_NODE = 103;//请求代码新节点 + + @Override + protected void onCreate(Bundle savedInstanceState) {//创建类 + super.onCreate(savedInstanceState);//super调用父类的protected函数,创建窗口时使用 + setContentView(R.layout.note_list);//设置内容的视图 + initResources();//初始化资源 + + /** + * Insert an introduction when user firstly use this application + */ + setAppInfoFromRawRes();//当第一次使用这个app的时候，插入介绍信息 + } + + @Override + protected void onActivityResult(int requestCode, int resultCode, Intent data) {//对子模块的一些数据进行分析 + if (resultCode == RESULT_OK + && (requestCode == REQUEST_CODE_OPEN_NODE || requestCode == REQUEST_CODE_NEW_NODE)) {//当被销毁的活动是打开便签或者新建便签，且结果码匹配时，把从编辑界面的光标数据删除 + mNotesListAdapter.changeCursor(null); + } else {//super调用父类的protected函数,创建窗口时使用 + super.onActivityResult(requestCode, resultCode, data);// 调用父类的方法 + } + } + + private void setAppInfoFromRawRes() {//通过原生资源设置APP信息 + SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this);//SharedPreferences类，用于保存配置参数 + if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) {//添加新的偏好设置 + StringBuilder sb = new StringBuilder();//读取原生资源信息 + InputStream in = null;//输入流初始设置为空 + try {//从原始配置文件当中获取基本信息 + in = getResources().openRawResource(R.raw.introduction);//加载Welcome to use MIUI notes!（本地xml文件） + if (in != null) {//如果信息不为空 + InputStreamReader isr = new InputStreamReader(in);// 使用指定的字符集读取字节并将它们解码为字符 + BufferedReader br = new BufferedReader(isr);//构建输入管道 + char [] buf = new char[1024]; + int len = 0; + while ((len = br.read(buf)) > 0) {//read读取一个字符，若读取到末尾则返回-1，这里是加载到buf中 + sb.append(buf, 0, len);//使用append函数在指定元素的结尾插入内容 + } + } else { + Log.e(TAG, "Read introduction file error");//报错，读取文件错误 + return; + } + } catch (IOException e) {//IO出错，打印异常信息 + e.printStackTrace();//在命令行打印异常信息在程序中出错的位置及原因 + return; + } finally {//close语句会自动执行，不需要显示的调用 + if(in != null) { + try { + in.close(); + } catch (IOException e) { + // TODO Auto-generated catch block + e.printStackTrace();//输出栈轨迹 + } + } + } + + WorkingNote note = WorkingNote.createEmptyNote(this, Notes.ID_ROOT_FOLDER,//创建新便签 + AppWidgetManager.INVALID_APPWIDGET_ID, Notes.TYPE_WIDGET_INVALIDE, + ResourceParser.RED); + note.setWorkingText(sb.toString());//设置文本数据 + if (note.saveNote()) {//这是一个判断语句，判断便签是否保存成功 + sp.edit().putBoolean(PREFERENCE_ADD_INTRODUCTION, true).commit();//保存note的数据信息 + } else { + Log.e(TAG, "Save introduction note error");//如果便签保存不成功，则把错误信息打印到日志里面。 + return; + } + } + } + + @Override + protected void onStart() {//在OnCreate函数运行完之后执行。用于获取便签列表 + super.onStart();//调用父类，启动活动 + startAsyncNotesListQuery();//同步列表中的便签信息 + } + + private void initResources() {//初始化资源 + mContentResolver = this.getContentResolver();//获取应用程序的数据，得到类似数据表的东西 + mBackgroundQueryHandler = new BackgroundQueryHandler(this.getContentResolver());//动态创建后台请求处理器的实例 + mCurrentFolderId = Notes.ID_ROOT_FOLDER;//当前文件夹ID是根目录ID + mNotesListView = (ListView) findViewById(R.id.notes_list);//根据R文件中的id值查询到相应的View,然后返回 + mNotesListView.addFooterView(LayoutInflater.from(this).inflate(R.layout.note_list_footer, null), + null, false);//使用布局填充器增加页脚视图 + mNotesListView.setOnItemClickListener(new OnListItemClickListener());// 设置视图点击监听器 + mNotesListView.setOnItemLongClickListener(this);//设置长按监听器 + mNotesListAdapter = new NotesListAdapter(this);//创建便签视图配置器 + mNotesListView.setAdapter(mNotesListAdapter);//.设置便签视图配置器 + mAddNewNote = (Button) findViewById(R.id.btn_new_note);//在activity中要获取该按钮 + mAddNewNote.setOnClickListener(this);//屏幕点击监视 + mAddNewNote.setOnTouchListener(new NewNoteOnTouchListener());//屏幕点击监听 + mDispatch = false;//是否调度，主要用于新建便签模块 + mDispatchY = 0;//初始y值设置为0 + mOriginY = 0;//加载文件夹下的标头资源 + mTitleBar = (TextView) findViewById(R.id.tv_title_bar);//设置Title bar，也就是app页面顶部的返回、选项、信息描述 + mState = ListEditState.NOTE_LIST;//功能描述：设置状态 + mModeCallBack = new ModeCallback();//.implements是一个类实现连接一个接口用的关键字，它是用来实现接口中定义的抽象方法 + } + + private class ModeCallback implements ListView.MultiChoiceModeListener, OnMenuItemClickListener {// implements声明自己使用一个或多个接口 + private DropdownMenu mDropDownMenu;//下拉菜单 + private ActionMode mActionMode;//动作方式 + private MenuItem mMoveMenu;//移动菜单 + + public boolean onCreateActionMode(ActionMode mode, Menu menu) {// 根据菜单和动作创建新动作 + getMenuInflater().inflate(R.menu.note_list_options, menu);//layout的xml布局文件实例化为View类对象 + menu.findItem(R.id.delete).setOnMenuItemClickListener(this);//为便签删除模块设定监听器 + mMoveMenu = menu.findItem(R.id.move);//调用下面的更新菜单函数 + if (mFocusNoteDataItem.getParentId() == Notes.ID_CALL_RECORD_FOLDER + || DataUtils.getUserFolderCount(mContentResolver) == 0) {//如果父类id在文件夹中保存或者用户文件数量为零，设置移动菜单为不可见，否者设为可见 + mMoveMenu.setVisible(false); + } else {//设置菜单项目为可见 + mMoveMenu.setVisible(true);//当长按某一标签时，会执行这个，让 移动到文件夹 按键变得可见 + mMoveMenu.setOnMenuItemClickListener(this);//设置菜单项监听器 + } + mActionMode = mode; + mNotesListAdapter.setChoiceMode(true);//进入选择模式 + mNotesListView.setLongClickable(false);//关闭长按列表项发生事件功能 + mAddNewNote.setVisibility(View.GONE);//隐藏了新增便签按钮 + + View customView = LayoutInflater.from(NotesListActivity.this).inflate(//设置用户界面 + R.layout.note_list_dropdown_menu, null);//加载下拉菜单的布局 + mode.setCustomView(customView); + mDropDownMenu = new DropdownMenu(NotesListActivity.this,//创建新的下拉菜单 + (Button) customView.findViewById(R.id.selection_menu), + R.menu.note_list_dropdown);//为view添加dropDownMenu（包含一个全选操作） + mDropDownMenu.setOnDropdownMenuItemClickListener(new PopupMenu.OnMenuItemClickListener(){ + public boolean onMenuItemClick(MenuItem item) {//点击菜单时，设置为全选并更新菜单 + mNotesListAdapter.selectAll(!mNotesListAdapter.isAllSelected());// 对应下拉菜单里的全选按键 + updateMenu();//更新菜单 + return true; + } + + });//更新下拉菜单 + return true; + } + + private void updateMenu() {//在多选便签/便签文件夹时调用，用于更新多选下拉菜单 + int selectedCount = mNotesListAdapter.getSelectedCount();//获取被勾选的条目数量 + // Update dropdown menu + String format = getResources().getString(R.string.menu_select_title, selectedCount);//从原始资源中读取信息更改下拉菜单内容 + mDropDownMenu.setTitle(format);//更改标题 + MenuItem item = mDropDownMenu.findItem(R.id.action_select_all);//通过判断是否全选选项 + if (item != null) {//当全选成功，则将“全选”菜单项改为“取消全选”菜单，否则仍保持“全选”菜单项。 + if (mNotesListAdapter.isAllSelected()) {//若便签被全选，则给出全不选按钮， 否则给出全选按钮 + item.setChecked(true);//若便签被全选，则给出全不选按钮， 否则给出全选按钮 + item.setTitle(R.string.menu_deselect_all); + } else { + item.setChecked(false); + item.setTitle(R.string.menu_select_all); + } + } + } + + public boolean onPrepareActionMode(ActionMode mode, Menu menu) {//准备动作模式 + // TODO Auto-generated method stub + return false; + } + + public boolean onActionItemClicked(ActionMode mode, MenuItem item) {//菜单动作触发标记 + // TODO Auto-generated method stub + return false; + } + + public void onDestroyActionMode(ActionMode mode) {//销毁动作模式，设置便签可见 + mNotesListAdapter.setChoiceMode(false);//设置笔记列表适配器选择方式 + mNotesListView.setLongClickable(true);//长按操作 + mAddNewNote.setVisibility(View.VISIBLE);//调整新建笔记为可见 + } + + public void finishActionMode() { + mActionMode.finish(); + }//菜单勾选状态改变 + + public void onItemCheckedStateChanged(ActionMode mode, int position, long id,//勾选状态改变时，更改勾选标志，更新菜单 + boolean checked) {//点击菜单选项触发操作 + mNotesListAdapter.setCheckedItem(position, checked);//改变勾选的状态 + updateMenu();//更新菜单 + } + + public boolean onMenuItemClick(MenuItem item) {//判断菜单是否被点击 + if (mNotesListAdapter.getSelectedCount() == 0) {//如果一次都没有点击，创建新的文本显示出来 + Toast.makeText(NotesListActivity.this, getString(R.string.menu_select_none),//Toast-Android系统中一种消息框类型 + Toast.LENGTH_SHORT).show(); + return true; + } + + switch (item.getItemId()) {//根据id号判断是删除还是移动 + case R.id.delete://删除菜单项 + AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);//警告对话框 + builder.setTitle(getString(R.string.alert_title_delete));//设置“删除选中的便签”的title + builder.setIcon(android.R.drawable.ic_dialog_alert);//设置提醒删除的图片 + builder.setMessage(getString(R.string.alert_message_delete_notes, + mNotesListAdapter.getSelectedCount()));//设置警告对话框的图标 + builder.setPositiveButton(android.R.string.ok,//设置否定按钮 + new DialogInterface.OnClickListener() { + public void onClick(DialogInterface dialog, + int which) { + batchDelete();//执行批量删除操作 + } + }); + builder.setNegativeButton(android.R.string.cancel, null);//取消按键的视图 + builder.show(); + break; + case R.id.move:// 移动便签到文件夹 + startQueryDestinationFolders();//启动查询目标文件函数 + break; + default://default，switch语句结束 + return false; + } + return true; + } + } + + private class NewNoteOnTouchListener implements OnTouchListener {//触摸便签监听器 + + public boolean onTouch(View v, MotionEvent event) {//新建便签的触摸事件的处理 + switch (event.getAction()) {//获取不同动作对应不同操作 + case MotionEvent.ACTION_DOWN: {//如果是创建新便签，通过计算调整界面大小 + Display display = getWindowManager().getDefaultDisplay(); + int screenHeight = display.getHeight();//获取屏幕高度 + int newNoteViewHeight = mAddNewNote.getHeight();// 获取新增便签的高度 + int start = screenHeight - newNoteViewHeight;//起始的y值 + int eventY = start + (int) event.getY();//event.getY相当于点击到的地方的y值 + /** + * Minus TitleBar's height + */ + if (mState == ListEditState.SUB_FOLDER) {//减去标题栏的高度 + eventY -= mTitleBar.getHeight(); + start -= mTitleBar.getHeight(); + } + /** + * HACKME:When click the transparent part of "New Note" button, dispatch//点击某个区域 + * the event to the list view behind this button. The transparent part of + * "New Note" button could be expressed by formula y=-0.12x+94（Unit:pixel） + * and the line top of the button. The coordinate based on left of the "New + * Note" button. The 94 represents maximum height of the transparent part.//点击按键 + * Notice that, if the background of the button changes, the formula should + * also change. This is very bad, just for the UI designer's strong requirement. + */ + if (event.getY() < (event.getX() * (-0.12) + 94)) {//如果当前点击的位置不在“写便签”区域内 + View view = mNotesListView.getChildAt(mNotesListView.getChildCount() - 1//最后得到最后一个元素的view（视图） + - mNotesListView.getFooterViewsCount());//减去页脚下元素布局数量 + if (view != null && view.getBottom() > start// 如果不在新建便签的按钮上，重新调度响应按键 + && (view.getTop() < (start + 94))) { + mOriginY = (int) event.getY();//初始按下时的垂直距离 + mDispatchY = eventY;//调度时的垂直距离 + event.setLocation(event.getX(), mDispatchY);//重新给触摸事件定位 + mDispatch = true;//触摸事件定位 + return mNotesListView.dispatchTouchEvent(event);//重新调度，即重新执行 + } + } + break; + } + case MotionEvent.ACTION_MOVE: {// 如果是移动操作，调度动作顺序 + if (mDispatch) { + mDispatchY += (int) event.getY() - mOriginY;//移动后，触摸事件位置发生变换 + event.setLocation(event.getX(), mDispatchY);//重新赋值 + return mNotesListView.dispatchTouchEvent(event);//重新调度，即重新执行 + } + break; + } + default: {//其他情况 + if (mDispatch) { + event.setLocation(event.getX(), mDispatchY);// 重新赋值 + mDispatch = false; + return mNotesListView.dispatchTouchEvent(event);// 重新调度，即重新执行 + } + break; + } + } + return false; + } + + }; + + private void startAsyncNotesListQuery() {//开始NoteList对数据库的异步查询 + String selection = (mCurrentFolderId == Notes.ID_ROOT_FOLDER) ? ROOT_FOLDER_SELECTION + : NORMAL_SELECTION;//如果当前文件id与保存在文件夹的id相同，selection为文件夹模式，否则为常规模式 + mBackgroundQueryHandler.startQuery(FOLDER_NOTE_LIST_QUERY_TOKEN, null,//后台异步对数据库进行操作，加快数据处理速度 + Notes.CONTENT_NOTE_URI, NoteItemData.PROJECTION, selection, new String[] { + String.valueOf(mCurrentFolderId) + }, NoteColumns.TYPE + " DESC," + NoteColumns.MODIFIED_DATE + " DESC"); + } + + private final class BackgroundQueryHandler extends AsyncQueryHandler {//背景请求处理器 + public BackgroundQueryHandler(ContentResolver contentResolver) { + super(contentResolver); + }//调用父类的方法 + + @Override//查询完成后对光标的处理 + protected void onQueryComplete(int token, Object cookie, Cursor cursor) {//查询完成后对光标的处理 + switch (token) { + case FOLDER_NOTE_LIST_QUERY_TOKEN //如果是便签查询被采用，更改光标位置 + mNotesListAdapter.changeCursor(cursor);//如果是便签查询被采用，更改光标位置 + break; + case FOLDER_LIST_QUERY_TOKEN://获取文件夹请求 + if (cursor != null && cursor.getCount() > 0) {//如果下面有便签，打开文件夹列表弹窗 + showFolderListMenu(cursor);//显示文件夹列表菜单，以提示对话框的形式 + } else { + Log.e(TAG, "Query folder failed");//写入错误异常日志 + } + break;//创建新便签 + default: + return; + } + } + } + + private void showFolderListMenu(Cursor cursor) {//执行批量删除的操作 + AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);//声明一个警告对话框 + builder.setTitle(R.string.menu_title_select_folder);//对话框的title是“选择文件夹” + final FoldersListAdapter adapter = new FoldersListAdapter(this, cursor);//文件夹列表配适器 + builder.setAdapter(adapter, new DialogInterface.OnClickListener() {//为对话框设置监听事件 + + public void onClick(DialogInterface dialog, int which) {//点击事件的处理方法 + DataUtils.batchMoveToFolder(mContentResolver,//移动到文件夹下 + mNotesListAdapter.getSelectedItemIds(), adapter.getItemId(which)); + Toast.makeText( + NotesListActivity.this, + getString(R.string.format_move_notes_to_folder,//移动便签进入文件夹 + mNotesListAdapter.getSelectedCount(), + adapter.getFolderName(NotesListActivity.this, which)), + Toast.LENGTH_SHORT).show(); + mModeCallBack.finishActionMode();//批量移动操作完成 + } + }); + builder.show();//显示对话框 + } + + private void createNewNote() {//创建新的便签 + Intent intent = new Intent(this, NoteEditActivity.class);//新建一个意图，与NoteEditActivity相关联 + intent.setAction(Intent.ACTION_INSERT_OR_EDIT);//参数为键名 + intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mCurrentFolderId);//设置键对值 + this.startActivityForResult(intent, REQUEST_CODE_NEW_NODE);//这个活动发出请求，等待下一个活动返回数据 + } + + private void batchDelete() {//批量删除便签 + new AsyncTask>() {//批量删除：删除时候，会判断是否为桌面挂件 + protected HashSet doInBackground(Void... unused) { + HashSet widgets = mNotesListAdapter.getSelectedWidget(); + if (!isSyncMode()) {//异步处理任务 + // if not synced, delete notes directly + if (DataUtils.batchDeleteNotes(mContentResolver, mNotesListAdapter + .getSelectedItemIds())) { + } else {//如果不是同步模式则将笔记移到垃圾文件夹，若转移失败打印错误信息 + Log.e(TAG, "Delete notes error, should not happens");//处于同步模式则将删除的便签移入回收文件夹 + } + } else { + // in sync mode, we'll move the deleted note into the trash//如果在同步模式，会将便签移动到“垃圾箱”文件夹 + // folder + if (!DataUtils.batchMoveToFolder(mContentResolver, mNotesListAdapter//同步状态先放入垃圾箱 + .getSelectedItemIds(), Notes.ID_TRASH_FOLER)) {//同步状态先放入回收站 + Log.e(TAG, "Move notes to trash folder error, should not happens"); + } + } + return widgets;//桌面widget修改 + } + + @Override + protected void onPostExecute(HashSet widgets) {//遍历所有的widget + if (widgets != null) { + for (AppWidgetAttribute widget : widgets) { + if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID//此处判断是否为一个widget + && widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) {//更新widget信息 + updateWidget(widget.widgetId, widget.widgetType);//更新桌面挂件 + } + } + }//结束动作 + mModeCallBack.finishActionMode();//结束动作 + } + }.execute(); + } + + private void deleteFolder(long folderId) {//删除文件夹 + if (folderId == Notes.ID_ROOT_FOLDER) {//不在列表里，输出错误信息 + Log.e(TAG, "Wrong folder id, should not happen " + folderId); + return; + } + + HashSet ids = new HashSet();//初始化一个哈希表 + ids.add(folderId);// 把文件夹id加入进去 + HashSet widgets = DataUtils.getFolderNoteWidget(mContentResolver, + folderId); + if (!isSyncMode()) {//如果不同步，直接删除 + // if not synced, delete folder directly + DataUtils.batchDeleteNotes(mContentResolver, ids);//如同步，将被删除的文件夹放入trash文件夹中 + } else {//否则放到回收站 + // in sync mode, we'll move the deleted folder into the trash folder//处于同步模式则放到“垃圾桶”文件夹里 + DataUtils.batchMoveToFolder(mContentResolver, ids, Notes.ID_TRASH_FOLER);//处于同步模式则放到回收站 + } + if (widgets != null) {//如果存在对应桌面挂件，那么判断挂件信息，如果挂件id有效且挂件类型有效，则更新挂件信息 + for (AppWidgetAttribute widget : widgets) { + if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID + && widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) { + updateWidget(widget.widgetId, widget.widgetType); + } + } + } + } + + private void openNode(NoteItemData data) {//打开节点，参数为数据 + Intent intent = new Intent(this, NoteEditActivity.class);//打开便签，创建新的活动，并且等待返回值 + intent.setAction(Intent.ACTION_VIEW); + intent.putExtra(Intent.EXTRA_UID, data.getId());//目的数据 + this.startActivityForResult(intent, REQUEST_CODE_OPEN_NODE); + } + + private void openFolder(NoteItemData data) {//打开文件夹 + mCurrentFolderId = data.getId();//获取当前文件夹的ID + startAsyncNotesListQuery();//开始异步的便签列表反馈 + if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {//如果当前id是保存在文件夹的id，将列表编辑状态置为call文件夹，否则设置为镜像文件夹 + mState = ListEditState.CALL_RECORD_FOLDER;//对标题栏的操作 + mAddNewNote.setVisibility(View.GONE);//将button“新建便签”置为不可见 + } else {//不然状态设置为子文件夹 + mState = ListEditState.SUB_FOLDER; + } + if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {//如果当前id是保存在文件夹的id，设置标题内容为文件夹名字，否则设置为文本的前部片段内容 + mTitleBar.setText(R.string.call_record_folder_name);//title设置为call notes + } else { + mTitleBar.setText(data.getSnippet());//否则文本的前部片段内容，即文件夹名称 + } + mTitleBar.setVisibility(View.VISIBLE);//将Activity的title设置为可见 + } + + public void onClick(View v) {//点击时进行的响应 + switch (v.getId()) {//得到我们所点击组件的ID号并进行判断 + case R.id.btn_new_note://当点击的组件是btn_new_note的时候创建一个新的标签 + createNewNote();//创建一个新的便签 + break; + default: + break; + } + } + + private void showSoftInput() {//显示软键盘 + InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);//获取方法的管理者对象 + if (inputMethodManager != null) {//若输入为空，进行对应操作 + inputMethodManager.toggleSoftInput(InputMethodManager.SHOW_FORCED, 0);//使软键盘显示，第二个参数hideFlags（用来设置是否隐藏）等于0 + } + } + + private void hideSoftInput(View view) {//关闭键盘 + InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE); + inputMethodManager.hideSoftInputFromWindow(view.getWindowToken(), 0);//隐藏软键盘 + } + + private void showCreateOrModifyFolderDialog(final boolean create) {//显示创建或者修改文件夹的对话框 + final AlertDialog.Builder builder = new AlertDialog.Builder(this);//初始化对话框 + View view = LayoutInflater.from(this).inflate(R.layout.dialog_edit_text, null);//图形创建，编辑对话框 + final EditText etName = (EditText) view.findViewById(R.id.et_foler_name);//编辑文本，通过ID获取名称. + showSoftInput();//显示键盘 + if (!create) {//如果create==false将对话框标题设置为 修改文件夹名称，否则设置为新建文件夹 + if (mFocusNoteDataItem != null) {//如果长按的对象（focus对象）不等于null + etName.setText(mFocusNoteDataItem.getSnippet());//获取片段来设置文档 + builder.setTitle(getString(R.string.menu_folder_change_name));//通过构建器设置标题 + } else {//显示此次点击显示为空 + Log.e(TAG, "The long click data item is null");//载入标签tag，报错 + return; + } + } else {//新建一个目录文件夹 + etName.setText("");//否则设置空文本 + builder.setTitle(this.getString(R.string.menu_create_folder));//设置“创建文件”的标题 + } + + builder.setPositiveButton(android.R.string.ok, null);//对话框设置确定和取消按钮 + builder.setNegativeButton(android.R.string.cancel, new DialogInterface.OnClickListener() {//构建器_创建取消的按键 + public void onClick(DialogInterface dialog, int which) {//点击触发软键盘隐藏 + hideSoftInput(etName);//：隐藏输入法软键盘 + } + }); + + final Dialog dialog = builder.setView(view).show();//将上述对话框实例化并显示在屏幕上 + final Button positive = (Button)dialog.findViewById(android.R.id.button1);//创建对话框的确认按钮 + positive.setOnClickListener(new OnClickListener() {//设置点击监听器 + public void onClick(View v) {//新建文件夹或者修改文件夹名同时判断其是否合法 + hideSoftInput(etName);//点击确定后收起软键盘 + String name = etName.getText().toString();//获取当前可编辑文本框etName的文本内容 + if (DataUtils.checkVisibleFolderName(mContentResolver, name)) {//检测可视文件夹的名字 + Toast.makeText(NotesListActivity.this, getString(R.string.folder_exist, name),//显示提示信息“文件夹‘name’已存在，请重新命名 + Toast.LENGTH_LONG).show(); + etName.setSelection(0, etName.length());//全选当前字符串 + return; + } + if (!create) {//若未创建 + if (!TextUtils.isEmpty(name)) {//如果输入不为空 + ContentValues values = new ContentValues();//创建内容取值 + values.put(NoteColumns.SNIPPET, name);//将片段名字添加入value + values.put(NoteColumns.TYPE, Notes.TYPE_FOLDER);//将文件夹类型添加入value + values.put(NoteColumns.LOCAL_MODIFIED, 1);//将本地修改添加入value + mContentResolver.update(Notes.CONTENT_NOTE_URI, values, NoteColumns.ID + + "=?", new String[] {//将内容笔记URI及笔记专栏ID更新至内容解决器 + String.valueOf(mFocusNoteDataItem.getId())//如果修改文件夹名字操作成功，则更新数据库内容 + }); + } + } else if (!TextUtils.isEmpty(name)) {//如果是新建文件夹操作 + ContentValues values = new ContentValues(); + values.put(NoteColumns.SNIPPET, name);//将SNIPPET加入内容值中 + values.put(NoteColumns.TYPE, Notes.TYPE_FOLDER);//将TYPE加入内容值中 + mContentResolver.insert(Notes.CONTENT_NOTE_URI, values);//将内容_笔记的URI插入到内容解决器 + } + dialog.dismiss();//撤销对话框 + } + }); + + if (TextUtils.isEmpty(etName.getText())) {//若文本为空，确认按钮设置使能为false + positive.setEnabled(false); + } + /** + * When the name edit text is null, disable the positive button + */ + etName.addTextChangedListener(new TextWatcher() {//添加文本改变监听器 + public void beforeTextChanged(CharSequence s, int start, int count, int after) {//判断是否在文本更改之前 + // TODO Auto-generated method stub + + } + + public void onTextChanged(CharSequence s, int start, int before, int count) {//当前文本改变触发，文本为空按键不可用，不为空则可用 + if (TextUtils.isEmpty(etName.getText())) {//如果文件夹名称为空，那么便不可用 + positive.setEnabled(false); + } else { + positive.setEnabled(true);//监听输入字符串，如果大于零，则button可以点击 + } + } + + public void afterTextChanged(Editable s) {//判断是否在文本更改之后 + // TODO Auto-generated method stub + + } + }); + } + + @Override + public void onBackPressed() {//点击后退键时的操作 + switch (mState) {//判断目前所处的状态 + case SUB_FOLDER://前两个状态返回到初始界面最后一个状态返回到桌面 + mCurrentFolderId = Notes.ID_ROOT_FOLDER;//如果是在文件夹中的状态 + mState = ListEditState.NOTE_LIST;//将当前文件夹id修改为根文件夹 + startAsyncNotesListQuery();//将当前状态改为一般状态 + mTitleBar.setVisibility(View.GONE);//隐藏TitleBar，设置为不可见 + break; + case CALL_RECORD_FOLDER://响应已记录文件夹的操作 + mCurrentFolderId = Notes.ID_ROOT_FOLDER;//将当前文件夹id修改为根文件夹 + mState = ListEditState.NOTE_LIST;//便签列表的返回 + mAddNewNote.setVisibility(View.VISIBLE);//设置button“新增便签”可见 + mTitleBar.setVisibility(View.GONE);//隐藏TitleBar，设置为不可见 + startAsyncNotesListQuery(); + break; + case NOTE_LIST://从主界面退出 + super.onBackPressed();//调用原来的onBackPressed方法 + break; + default://其他情况直接break + break; + } + } + + private void updateWidget(int appWidgetId, int appWidgetType) {//更新桌面widget小工具，设置内容、格式 + Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);//初始化部件大小管理 + if (appWidgetType == Notes.TYPE_WIDGET_2X) {//下面是判断不同类型widget的操作并建立不同的类型 + intent.setClass(this, NoteWidgetProvider_2x.class);//将便签插件提供器的类型设置成内容的类型 + } else if (appWidgetType == Notes.TYPE_WIDGET_4X) {//判断不同类型widget的操作并建立不同的类型 + intent.setClass(this, NoteWidgetProvider_4x.class); + } else { + Log.e(TAG, "Unspported widget type");//否则显示“不支持的插件类型 + return;//返回错误日志信息 + } + + intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] {//putExtra中两个参数为键对值，第一个参数为键名 + appWidgetId + }); + + sendBroadcast(intent);//设置成功的结果 + setResult(RESULT_OK, intent);//返回给上一个活动数据 + } + + private final OnCreateContextMenuListener mFolderOnCreateContextMenuListener = new OnCreateContextMenuListener() {//对文件夹进行操作的菜单 + public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) {//创建目录的视图 + if (mFocusNoteDataItem != null) {//当笔记数据项不为空时,设置菜单 + menu.setHeaderTitle(mFocusNoteDataItem.getSnippet());//设置菜单的题目是当前文件夹名字 + menu.add(0, MENU_FOLDER_VIEW, 0, R.string.menu_folder_view);//在菜单中新增项目“查看文件夹” + menu.add(0, MENU_FOLDER_DELETE, 0, R.string.menu_folder_delete);//在菜单中新增项目“删除文件夹” + menu.add(0, MENU_FOLDER_CHANGE_NAME, 0, R.string.menu_folder_change_name);//在菜单中新增项目“修改文件夹名称” + } + } + }; + + @Override + public void onContextMenuClosed(Menu menu) {//关闭菜单 + if (mNotesListView != null) { + mNotesListView.setOnCreateContextMenuListener(null);//不设置监听事件 + } + super.onContextMenuClosed(menu); + } + + @Override + public boolean onContextItemSelected(MenuItem item) {//对菜单项进行选择对应的相应 + if (mFocusNoteDataItem == null) {//若笔记数据项为空 + Log.e(TAG, "The long click data item is null");//设置标签“长按数据项为空 + return false; + } + switch (item.getItemId()) {//通过获取项目ID，进行switch + case MENU_FOLDER_VIEW://打开文件夹 + openFolder(mFocusNoteDataItem); + break; + case MENU_FOLDER_DELETE://文件夹删除 + AlertDialog.Builder builder = new AlertDialog.Builder(this);//新建一个警告对话框，来警告是否确认删除文件夹 + builder.setTitle(getString(R.string.alert_title_delete));//设置警告对话框题目为“删除” + builder.setIcon(android.R.drawable.ic_dialog_alert);//设置警告对话框图标为”三角感叹号“ + builder.setMessage(getString(R.string.alert_message_delete_folder));//设置警告信息文本“确认删除文件夹及所包含的便签” + builder.setPositiveButton(android.R.string.ok, + new DialogInterface.OnClickListener() {//设置取消按键 + public void onClick(DialogInterface dialog, int which) { + deleteFolder(mFocusNoteDataItem.getId());//点击删除文件夹 + } + }); + builder.setNegativeButton(android.R.string.cancel, null);//设置button“取消” + builder.show(); + break; + case MENU_FOLDER_CHANGE_NAME://修改目录文件夹的名称 + showCreateOrModifyFolderDialog(false);//不显示创建or修改文件夹的对话框 + break; + default: + break; + } + + return true; + } + + @Override + public boolean onPrepareOptionsMenu(Menu menu) {//创建菜单这个方法在每一次调用菜单的时候都会执行 + menu.clear();//把原先的菜单删除 + if (mState == ListEditState.NOTE_LIST) {//当状态为当前笔记列表状态时，设置同步或取消同步 + getMenuInflater().inflate(R.menu.note_list, menu);//加载目录的布局 + // set sync or sync_cancel//设置同步标题 + menu.findItem(R.id.menu_sync).setTitle( + GTaskSyncService.isSyncing() ? R.string.menu_sync_cancel : R.string.menu_sync);//为同步菜单项设置标题，如果正在同步中则显示“取消同步”，否则显示“同步” + } else if (mState == ListEditState.SUB_FOLDER) {//当状态为当前子文件夹状态时，扩充子文件夹 + getMenuInflater().inflate(R.menu.sub_folder, menu);//采用布局文件R.menu.sub_folder来构建菜单项 + } else if (mState == ListEditState.CALL_RECORD_FOLDER) {//当状态为当调用记录文件夹时，扩充记录文件夹的菜单 + getMenuInflater().inflate(R.menu.call_record_folder, menu);//采用布局文件R.menu.call_record_folder来构建菜单项 + } else {//否则设置标签为“错误状态”+当前状态 + Log.e(TAG, "Wrong state:" + mState);//报错日志信息 + } + return true; + } + + @Override + public boolean onOptionsItemSelected(MenuItem item) {//实现菜单项目的操作，通过case语句对各个菜单项目分别设置事件 + switch (item.getItemId()) {//选择不同的项目名称 + case R.id.menu_new_folder: {//创建新目录的选项 + showCreateOrModifyFolderDialog(true); + break; + } + case R.id.menu_export_text: {//目录中输出文本内容的选项 + exportNoteToText(); + break; + } + case R.id.menu_sync: {//同步菜单 + if (isSyncMode()) {//同步 + if (TextUtils.equals(item.getTitle(), getString(R.string.menu_sync))) {//如果项目title与菜单同步相同，则进行同步 + GTaskSyncService.startSync(this);//利用到GTaskSyncService的类 + } else {//否则取消同步 + GTaskSyncService.cancelSync(this); + } + } else {//如果不是同步模式，则开始设置动作 + startPreferenceActivity();//.否则进行Preference活动 + } + break; + } + case R.id.menu_setting: {//设置菜单 + startPreferenceActivity(); + break; + } + case R.id.menu_new_note: {//新建便签 + createNewNote(); + break; + } + case R.id.menu_search://搜索 + onSearchRequested();//查询 + break; + default: + break; + } + return true; + } + + @Override + public boolean onSearchRequested() {//根据关键字搜索便签（还未实现） + startSearch(null, false, null /* appData */, false); + return true; + } + + private void exportNoteToText() {//将便签导出 + final BackupUtils backup = BackupUtils.getInstance(NotesListActivity.this);//备份笔记信息 + new AsyncTask() {//异步任务 + + @Override + protected Integer doInBackground(Void... unused) { + return backup.exportToText(); + }//未被占用的话后台进行 + + @Override + protected void onPostExecute(Integer result) {//设置备份的结果响应 + if (result == BackupUtils.STATE_SD_CARD_UNMOUONTED) {//如果SD卡无响应，则提示用户 “导出失败，SD卡繁忙” + AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this); + builder.setTitle(NotesListActivity.this + .getString(R.string.failed_sdcard_export)); + builder.setMessage(NotesListActivity.this + .getString(R.string.error_sdcard_unmounted)); + builder.setPositiveButton(android.R.string.ok, null); + builder.show(); + } else if (result == BackupUtils.STATE_SUCCESS) {//如果导出成功，则显示相应对话框 + AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);//如果导出成功，则显示成功 + //并且会显示“Export text file 《便签名称》 to SD 《目录名称》 directory” + builder.setTitle(NotesListActivity.this//设置标题 + .getString(R.string.success_sdcard_export)); + builder.setMessage(NotesListActivity.this.getString( + R.string.format_exported_file_location, backup + .getExportedTextFileName(), backup.getExportedTextFileDir())); + builder.setPositiveButton(android.R.string.ok, null);//设置响应按钮 + builder.show(); + } else if (result == BackupUtils.STATE_SYSTEM_ERROR) { + AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this); + builder.setTitle(NotesListActivity.this + .getString(R.string.failed_sdcard_export)); + builder.setMessage(NotesListActivity.this + .getString(R.string.error_sdcard_export)); + builder.setPositiveButton(android.R.string.ok, null); + builder.show(); + } + } + + }.execute(); + } + + private boolean isSyncMode() {//判断是否处于同步模式 + return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;//转到PreferenceActivity + } + + private void startPreferenceActivity() {//跳转到设置界面 + Activity from = getParent() != null ? getParent() : this;//设置便签函数 + Intent intent = new Intent(from, NotesPreferenceActivity.class); + from.startActivityIfNeeded(intent, -1);//请求码为-1，表示此活动结束后不会通知原活动 + } + + private class OnListItemClickListener implements OnItemClickListener {//当短按标签列表项时的响应 + + public void onItemClick(AdapterView parent, View view, int position, long id) {//项目被点击的响应 + if (view instanceof NotesListItem) {//判断view是否是NotesListItem的一个实例，如果是就获取他的项目信息装入item中 + NoteItemData item = ((NotesListItem) view).getItemData(); + if (mNotesListAdapter.isInChoiceMode()) {//如果列表适配器被选择并且项是便签类型的，则修改位置和状态信息 + if (item.getType() == Notes.TYPE_NOTE) {//如果点到的item是便签 + position = position - mNotesListView.getHeaderViewsCount();//减去头部视图的元素项，得到列表的元素索引值 + mModeCallBack.onItemCheckedStateChanged(null, position, id,//改变对应索引的Item是否被选中的状态 + !mNotesListAdapter.isSelectedItem(position)); + } + return; + } + + switch (mState) {//区别情况进行处理 + case NOTE_LIST://便签列表 + if (item.getType() == Notes.TYPE_FOLDER + || item.getType() == Notes.TYPE_SYSTEM) { + openFolder(item);//查询目标文件夹 + } else if (item.getType() == Notes.TYPE_NOTE) { + openNode(item); + } else { + Log.e(TAG, "Wrong note type in NOTE_LIST"); + } + break; + case SUB_FOLDER: + case CALL_RECORD_FOLDER: + if (item.getType() == Notes.TYPE_NOTE) { + openNode(item); + } else { + Log.e(TAG, "Wrong note type in SUB_FOLDER"); + } + break; + default: + break; + } + } + } + + } + + private void startQueryDestinationFolders() {//查询目标文件 + String selection = NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>? AND " + NoteColumns.ID + "<>?";//按下移动便签后，开始查找所有的文件夹 + selection = (mState == ListEditState.NOTE_LIST) ? selection: + "(" + selection + ") OR (" + NoteColumns.ID + "=" + Notes.ID_ROOT_FOLDER + ")"; + + mBackgroundQueryHandler.startQuery(FOLDER_LIST_QUERY_TOKEN, + null, + Notes.CONTENT_NOTE_URI,//长按某一项时进行的操作如果长按的是便签，则通过ActionMode菜单实现 + FoldersListAdapter.PROJECTION, + selection,//长按某一项时进行的操作 如果长按的是便签，则通过ActionMode菜单实现；如果长按的是文件夹，则通过ContextMenu菜单实现； + new String[] {//新建字符列表 + String.valueOf(Notes.TYPE_FOLDER), + String.valueOf(Notes.ID_TRASH_FOLER), + String.valueOf(mCurrentFolderId) + }, + NoteColumns.MODIFIED_DATE + " DESC"); + } + + public boolean onItemLongClick(AdapterView parent, View view, int position, long id) {//长按的响应 + if (view instanceof NotesListItem) {//判断view是否是NotesListItem的一个实例，如果是就获取他的项目信息装入item中 + mFocusNoteDataItem = ((NotesListItem) view).getItemData();//聚焦的Item对象 + if (mFocusNoteDataItem.getType() == Notes.TYPE_NOTE && !mNotesListAdapter.isInChoiceMode()) {//长按的对象是便签时的处理，通过ActionMode实现 + if (mNotesListView.startActionMode(mModeCallBack) != null) { + mModeCallBack.onItemCheckedStateChanged(null, position, id, true);//开始对单个便签进行操作 + mNotesListView.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS); + } else {//长按的对象是文件夹时的处理，通过ContextMenu实现 + Log.e(TAG, "startActionMode fails"); + } + } else if (mFocusNoteDataItem.getType() == Notes.TYPE_FOLDER) {//如果长按的的项目是文件夹类型，则执行ContextMenu菜单的实现 + mNotesListView.setOnCreateContextMenuListener(mFolderOnCreateContextMenuListener); + } + } + return false; + } +} diff --git a/src/notes/ui/NotesListAdapter.java b/src/notes/ui/NotesListAdapter.java new file mode 100644 index 0000000..94d1b4b --- /dev/null +++ b/src/notes/ui/NotesListAdapter.java @@ -0,0 +1,185 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.ui;//引入tools包 + +import android.content.Context;//第19到31行导入各种类 +import android.database.Cursor;//光标 +import android.util.Log; +import android.view.View; +import android.view.ViewGroup; +import android.widget.CursorAdapter; + +import net.micode.notes.data.Notes; + +import java.util.Collection;//便签连接器 可能是 实现便签的编辑 +import java.util.HashMap; +import java.util.HashSet; +import java.util.Iterator; + + +public class NotesListAdapter extends CursorAdapter {//直译为便签列表适配器，继承自光标适配器，功能为：实现了鼠标与编辑便签的连接 + private static final String TAG = "NotesListAdapter";//设置标签字符常量 + private Context mContext;//便签数 + private HashMap mSelectedIndex;//HashMap是一个散列表，储存键值对的映射关系 + private int mNotesCount;//便签数 + private boolean mChoiceMode;//选择模式标志 + + public static class AppWidgetAttribute {//桌面widget的属性，包括编号和类型 + public int widgetId;//初始化便签链接器 + public int widgetType; + }; + + public NotesListAdapter(Context context) {// 初始化便签链接 + super(context, null);//功能描述：NoteListAdapter的构造函数 + //函数实现：继承父类函数；设置HashMap的map表，实现选择item与是否选择的键值对；设置context上下文；初始化note数量为0 + mSelectedIndex = new HashMap();//新建哈希表 + mContext = context;//新建一个视图来存储光标所指向的数据 + mNotesCount = 0;//初始便签数为0 + } + + @Override + public View newView(Context context, Cursor cursor, ViewGroup parent) {//利用NotesListLtem类创建新布局 + return new NotesListItem(context);//使用noteslistitem类新建一个项目选项 + } + + @Override + public void bindView(View view, Context context, Cursor cursor) {//将已经存在的视图和鼠标指向的数据进行捆绑 + if (view instanceof NotesListItem) {//如果view是NotesListItem的实例 + NoteItemData itemData = new NoteItemData(context, cursor);//新建一个项目选项并且用bind跟将view和鼠标，内容，便签数据捆绑在一起 + ((NotesListItem) view).bind(context, itemData, mChoiceMode,//用光标指向的内容新建项目并将数据、项目、鼠标、视图捆绑起来 + isSelectedItem(cursor.getPosition())); + } + } + + public void setCheckedItem(final int position, final boolean checked) {//设置勾选框 + mSelectedIndex.put(position, checked);//根据定位和是否勾选设置下标 + notifyDataSetChanged();//在修改后刷新activity + } + + public boolean isInChoiceMode() { + return mChoiceMode; + }//判断单选按钮是否勾选，设置单项选项框 + + public void setChoiceMode(boolean mode) {//重置下标，并根据参数mode设置选项 + mSelectedIndex.clear();//清空勾选下表并根据当前mode设置 + mChoiceMode = mode; + } + + public void selectAll(boolean checked) {//选择全部选项，遍历所有光标可用的位置在判断为便签类型之后勾选单项框 + Cursor cursor = getCursor();//获取光标位置 + for (int i = 0; i < getCount(); i++) {//遍历可用光标位置，如果光标移动且光标当前指向的便签项目类型为TYPE_NOTE则设置为勾选状态 + if (cursor.moveToPosition(i)) {//遍历所有位置并设置勾选标志 + if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {//如果是便签状态 + setCheckedItem(i, checked);// 将位置i标志为已勾选加入到 mSelectedIndex中 + } + } + } + } + + public HashSet getSelectedItemIds() {//建立选择项目的ID的HASH表 + HashSet itemSet = new HashSet();//建立一个选项集合 + for (Integer position : mSelectedIndex.keySet()) {//遍历所有的关键 + if (mSelectedIndex.get(position) == true) {//判断光标位置是否可用 + Long id = getItemId(position); + if (id == Notes.ID_ROOT_FOLDER) {//原文件不需要添加，则将id该下标假如选项集合中 + Log.d(TAG, "Wrong item id, should not happen");//原文件不需要添加 + } else {//如果不是，则加入条目集合 + itemSet.add(id);//将该id加入到选项集合当中 + } + } + } + + return itemSet;//返回条目集合 + } + + public HashSet getSelectedWidget() {//建立桌面widget选项表 + HashSet itemSet = new HashSet();//类似于getselecteditemids的实现方法 + for (Integer position : mSelectedIndex.keySet()) {//如果光标位置可用 + if (mSelectedIndex.get(position) == true) { + Cursor c = (Cursor) getItem(position);//用c记录光标位置以判断是否选择了桌面挂件（可用） + if (c != null) {//获取光标位置可用 + AppWidgetAttribute widget = new AppWidgetAttribute();//新建widget并更新ID和类型，最后添加到选项表中 + NoteItemData item = new NoteItemData(mContext, c);//初始化所选桌面挂件信息加入到itemSet中 + widget.widgetId = item.getWidgetId(); + widget.widgetType = item.getWidgetType(); + itemSet.add(widget);//加入条目集合 + /** + * Don't close cursor here, only the adapter could close it + */ + } else {//在这里，不关闭光标，而是在adapter中才能关闭光标 + Log.e(TAG, "Invalid cursor");//设置标签，无效的cursor + return null; + } + } + } + return itemSet; + } + + public int getSelectedCount() {//被选中的进行计数的函数 + Collection values = mSelectedIndex.values();//获取选项下标的值 + if (null == values) {//如果此项值为空贼返回0 + return 0; + } + Iterator iter = values.iterator();//初始化迭代器 + int count = 0; + while (iter.hasNext()) {//如果iter后面还有，则count加一 + if (true == iter.next()) {//value值为真则count加一 + count++; + } + } + return count; + } + + public boolean isAllSelected() {//判断是否全选 + int checkedCount = getSelectedCount();//通过获得计数的结果与小米便签中的数量相比较 + return (checkedCount != 0 && checkedCount == mNotesCount);//对比选项数和总数是否一致且不为0 + } + + public boolean isSelectedItem(final int position) {//判断是否为选项表 + if (null == mSelectedIndex.get(position)) {//选项下标为空则不是 + return false; + } + return mSelectedIndex.get(position);//判断Item是否被选中的状态 + } + + @Override + protected void onContentChanged() {//activity内容变动时调用calcNotesCount计算便签数量 + super.onContentChanged();//执行父类函数 + calcNotesCount(); + } + + @Override + public void changeCursor(Cursor cursor) {//activity光标变动时调用calcNotesCount计算便签数量 + super.changeCursor(cursor);//重载父类函数 + calcNotesCount();//calcNotesCount函数实现 + } + + private void calcNotesCount() {//实现方式类似前面代码中的selectAll函数 + mNotesCount = 0; + for (int i = 0; i < getCount(); i++) {//获取总数同时遍历 + Cursor c = (Cursor) getItem(i);//遍历所有选项 + if (c != null) {//判断语句，如果光标不是null，那么便得到信息，便签数目加1 + if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {//若选项的数据类型为便签类型，那么计数+1 + mNotesCount++; + } + } else {//设置为无效的光标 + Log.e(TAG, "Invalid cursor");//否则就将设置为无效的光标 + return; + } + } + } +} diff --git a/src/notes/ui/NotesListItem.java b/src/notes/ui/NotesListItem.java new file mode 100644 index 0000000..0c98f49 --- /dev/null +++ b/src/notes/ui/NotesListItem.java @@ -0,0 +1,122 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.ui;//引入需要用到的包 + +import android.content.Context;//第19到30行导入各种类 +import android.text.format.DateUtils; +import android.view.View;//导入类 +import android.widget.CheckBox; +import android.widget.ImageView; +import android.widget.LinearLayout;//标签列表项目选项 +import android.widget.TextView; + +import net.micode.notes.R; +import net.micode.notes.data.Notes; +import net.micode.notes.tool.DataUtils; +import net.micode.notes.tool.ResourceParser.NoteItemBgResources; + + +public class NotesListItem extends LinearLayout {//构建便签列表的各个项目的详细具体信息 + private ImageView mAlert;//闹钟图片 + private TextView mTitle;//标题 + private TextView mTime;//时间 + private TextView mCallName;//名字 + private NoteItemData mItemData;//标签数据 + private CheckBox mCheckBox;//勾选框 + + public NotesListItem(Context context) {//初始化 + super(context);//super()它的主要作用是调整调用父类构造函数的顺序 + inflate(context, R.layout.note_item, this);//Inflate()作用就是将xml定义的一个布局找出来 + mAlert = (ImageView) findViewById(R.id.iv_alert_icon);//findViewById用于从contentView中查找指定ID的View，转换出来的形式根据需要而定 + mTitle = (TextView) findViewById(R.id.tv_title);// 获取题目（文件夹或便签项上的文本） + mTime = (TextView) findViewById(R.id.tv_time);//获取创建或修改时间 + mCallName = (TextView) findViewById(R.id.tv_name);//获取联系人姓名 + mCheckBox = (CheckBox) findViewById(android.R.id.checkbox);//获取复选框 + } + + public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {//根据data的属性对各个控件的属性的控制，主要是可见性Visibility，内容setText，格式setTextAppearance + if (choiceMode && data.getType() == Notes.TYPE_NOTE) {//如果当前处于选择模式下且数据类型为便签 + mCheckBox.setVisibility(View.VISIBLE);//设置View可见 + mCheckBox.setChecked(checked);//设置勾选 + } else { + mCheckBox.setVisibility(View.GONE);//设置复选框不可见 + } + + mItemData = data;//把数据传给标签 + if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {//设置控件属性，通过判断保存到文件夹的ID、当前ID以及父ID之间关系决定 + mCallName.setVisibility(View.GONE);//设置联系人名字不可见 + mAlert.setVisibility(View.VISIBLE);//设置闹钟图标可见 + mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);//设置外观风格 + mTitle.setText(context.getString(R.string.call_record_folder_name) + + context.getString(R.string.format_folder_files_count, data.getNotesCount()));//设置title的内容（文件夹名字+数量） + mAlert.setImageResource(R.drawable.call_record);//设置图片来源 + } else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {//设置闹钟 + mCallName.setVisibility(View.VISIBLE);//设置联系人姓名可见 + mCallName.setText(data.getCallName());//设置联系人姓名的文本内容 + mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem);//设置title文本风格 + mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));//设置title的文本内容为便签内容的前面片段 + if (data.hasAlert()) {//如果当前便签存在提醒时间 + mAlert.setImageResource(R.drawable.clock);//图片来源的设置 + mAlert.setVisibility(View.VISIBLE);//将提醒图标设置为可见 + } else { + mAlert.setVisibility(View.GONE);//否则将提醒图标设置为不可见 + } + } else { + mCallName.setVisibility(View.GONE);//设置联系人姓名不可见 + mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);//设置title的文本格式 + + if (data.getType() == Notes.TYPE_FOLDER) {//设置Type格式 + mTitle.setText(data.getSnippet() + + context.getString(R.string.format_folder_files_count, + data.getNotesCount()));//设置便签标题内容为便签的前面部分的内容+文件数+便签数 + mAlert.setVisibility(View.GONE);//设置图标不可见 + } else { + mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet())); + if (data.hasAlert()) { + mAlert.setImageResource(R.drawable.clock); + mAlert.setVisibility(View.VISIBLE); + } else { + mAlert.setVisibility(View.GONE);//否则设置提醒图标不可见 + } + } + } + mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));//将时间设置为编辑便签的时间 + + setBackground(data);//设置背景 + } + + private void setBackground(NoteItemData data) {//通过data设置背景 + int id = data.getBgColorId();//获取id，用此id用来获取背景颜色 + if (data.getType() == Notes.TYPE_NOTE) {//若是note型文件，则4种情况，对于4种不同情况的背景来源 + if (data.isSingle() || data.isOneFollowingFolder()) {//单个数据或只有一个子文件夹 + setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id)); + } else if (data.isLast()) {//最后一个数据 + setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id)); + } else if (data.isFirst() || data.isMultiFollowingFolder()) {//设置背景来源为id的最后一个数据 + setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id));//.若不是Note类型则使用文件夹背景来源 + } else { + setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id));//设置背景来源为id的普通数据 + } + } else {//如果不是便签类型的数据 + setBackgroundResource(NoteItemBgResources.getFolderBgRes());//设置背景来源为文件夹 + } + } + + public NoteItemData getItemData() { + return mItemData; + }//返回当前便签的数据信息 +} diff --git a/src/notes/ui/NotesPreferenceActivity.java b/src/notes/ui/NotesPreferenceActivity.java new file mode 100644 index 0000000..7a721da --- /dev/null +++ b/src/notes/ui/NotesPreferenceActivity.java @@ -0,0 +1,388 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.ui;//引入ui包 + +import android.accounts.Account;//第19到48行导入各种类 +import android.accounts.AccountManager; +import android.app.ActionBar; +import android.app.AlertDialog; +import android.content.BroadcastReceiver; +import android.content.ContentValues; +import android.content.Context;//文本 +import android.content.DialogInterface;//对话 +import android.content.Intent; +import android.content.IntentFilter; +import android.content.SharedPreferences; +import android.os.Bundle; +import android.preference.Preference; +import android.preference.Preference.OnPreferenceClickListener; +import android.preference.PreferenceActivity;//继承PreferenceActivity，主要功能为对系统配置进行自动保存以及实现用户同步的操作 +import android.preference.PreferenceCategory; +import android.text.TextUtils; +import android.text.format.DateFormat; +import android.view.LayoutInflater; +import android.view.Menu; +import android.view.MenuItem; +import android.view.View; +import android.widget.Button;//按钮 +import android.widget.TextView; +import android.widget.Toast; + +import net.micode.notes.R; +import net.micode.notes.data.Notes;//引入R包 +import net.micode.notes.data.Notes.NoteColumns;//小米便签栏 +import net.micode.notes.gtask.remote.GTaskSyncService; + + +public class NotesPreferenceActivity extends PreferenceActivity {//NotesPreferenceActivity，在小米便签中主要实现的是对背景颜色和字体大小的数据储存。 + public static final String PREFERENCE_NAME = "notes_preferences";//继承了PreferenceActivity主要功能为对系统信息和配置进行自动保存的Activity + + public static final String PREFERENCE_SYNC_ACCOUNT_NAME = "pref_key_account_name";//同步账户名 + + public static final String PREFERENCE_LAST_SYNC_TIME = "pref_last_sync_time";//最后同步时间 + + public static final String PREFERENCE_SET_BG_COLOR_KEY = "pref_key_bg_random_appear";//设置颜色按键 + + private static final String PREFERENCE_SYNC_ACCOUNT_KEY = "pref_sync_account_key";//账户同步密码 + + private static final String AUTHORITIES_FILTER_KEY = "authorities";//本地密码 + + private PreferenceCategory mAccountCategory;//账户分组 + + private GTaskReceiver mReceiver;//同步任务接收器 + + private Account[] mOriAccounts;//账户 + + private boolean mHasAddedAccount;//账户标记 + + @Override + protected void onCreate(Bundle icicle) {//新建Activity + super.onCreate(icicle);//执行父类创建函数 + + /* using the app icon for navigation */ + getActionBar().setDisplayHomeAsUpEnabled(true);//给左上角图标的左边加上一个返回的图标 + + addPreferencesFromResource(R.xml.preferences);//给左上角图标的左边加上一个返回的图标 + mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);//根据同步账户密码进行账户分组 + mReceiver = new GTaskReceiver();//根据同步账户关键码来初始化分组 + IntentFilter filter = new IntentFilter();//设置过滤项 + filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME); + registerReceiver(mReceiver, filter);//初始化同步组件 + + mOriAccounts = null;//初始化同步组件 + View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);//从xml获取Listview + getListView().addHeaderView(header, null, true);//在listview组件上方添加其它组件 + } + + @Override + protected void onResume() {//activity交互功能的实现，用于接受用户的输入 + super.onResume(); + + // need to set sync account automatically if user has added a new + // account + if (mHasAddedAccount) {//若用户新加了账户则自动设置同步账户 + Account[] accounts = getGoogleAccounts();//获取google账户 + if (mOriAccounts != null && accounts.length > mOriAccounts.length) {//若账户不为空且账户增加 + for (Account accountNew : accounts) {//遍历账户 + boolean found = false;//更新账户 + for (Account accountOld : mOriAccounts) {//循环判断当前账户列表中的账户是否与新建账户名相同 + if (TextUtils.equals(accountOld.name, accountNew.name)) {//若没找到旧账户则只设置新账户为同步账户 + found = true;//更新账户 + break;//若是没有找到旧的账户，那么同步账号中就只添加新账户 + } + } + if (!found) {//若是没有找到旧的账户，那么同步账号中就只添加新账户 + setSyncAccount(accountNew.name);//保存该账户 + break; + } + } + } + } + + refreshUI(); + } + + @Override + protected void onDestroy() {//销毁Activity + if (mReceiver != null) {//销毁接收器 + unregisterReceiver(mReceiver);//注销接收器 + } + super.onDestroy();//执行销毁动作 + } + + private void loadAccountPreference() {//设置账户信息 + mAccountCategory.removeAll();//移除所有分组 + + Preference accountPref = new Preference(this);//建立首选项 + final String defaultAccount = getSyncAccountName(this);//默认账户为当前账户 + accountPref.setTitle(getString(R.string.preferences_account_title));//首选项的大小标题 + accountPref.setSummary(getString(R.string.preferences_account_summary));//与google task同步便签记录 + accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {//建立监听器 + public boolean onPreferenceClick(Preference preference) {//判断是否处于同步模式和默认的数据，指向不同的操作 + if (!GTaskSyncService.isSyncing()) {//不在同步状态下，如果没有默认的账户，显示选择账户的对话框，否则显示需要改变账户的对话框 + if (TextUtils.isEmpty(defaultAccount)) {//第一次设置账户 + // the first time to set account + showSelectAccountAlertDialog();//第一次建立账户，显示选择账户提示对话框 + } else {//若是账户已经存在，则显示修改对话框并进行修改操作 + // if the account has already been set, we need to promp + // user about the risk + showChangeAccountConfirmAlertDialog();//已有账户则显示确认对话框 + } + } else {//若在没有同步的情况下，则在toast中显示不能修改 + Toast.makeText(NotesPreferenceActivity.this, + R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT) + .show(); + } + return true; + } + }); + + mAccountCategory.addPreference(accountPref);//根据新建首选项编辑新的账户分组 + } + + private void loadSyncButton() {//设置同步按键和最近同步时间 + Button syncButton = (Button) findViewById(R.id.preference_sync_button);//配置资源，设置一个button + TextView lastSyncTimeView = (TextView) findViewById(R.id.prefenerece_sync_status_textview);//获取同步按键和同步时间显示 + + // set button state + if (GTaskSyncService.isSyncing()) {//同步状态下按键显示“取消同步”，设置相关监听器 + syncButton.setText(getString(R.string.preferences_button_sync_cancel)); + syncButton.setOnClickListener(new View.OnClickListener() {//设置点击监听器 + public void onClick(View v) {//设置取消同步的响应方法 + GTaskSyncService.cancelSync(NotesPreferenceActivity.this);//响应点击的行为：取消同步 + } + }); + } else {//非同步状态下按键显示“立即同步”，设置相关监听器 + syncButton.setText(getString(R.string.preferences_button_sync_immediately));//若是不同步则设置按钮显示的文本为“立即同步”以及对应监听器 + syncButton.setOnClickListener(new View.OnClickListener() { + public void onClick(View v) {//点击行为 + GTaskSyncService.startSync(NotesPreferenceActivity.this);//开始同步 + } + }); + } + syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));//如果没有账户，则不可选“立即同步”的按键 + + // set last sync time + if (GTaskSyncService.isSyncing()) {//设置按键的可用性 + lastSyncTimeView.setText(GTaskSyncService.getProgressString()); + lastSyncTimeView.setVisibility(View.VISIBLE);//根据当前同步服务器设置时间显示框的文本以及可见性 + } else {//若是非同步情况 + long lastSyncTime = getLastSyncTime(this); + if (lastSyncTime != 0) {//如果有上次修改时间 + lastSyncTimeView.setText(getString(R.string.preferences_last_sync_time, + DateFormat.format(getString(R.string.preferences_last_sync_time_format), + lastSyncTime)));//非同步时，若最近同步时间不为0则显示最近同步时间 + lastSyncTimeView.setVisibility(View.VISIBLE);//根据最后同步时间的信息来编辑时间显示框的文本内容和可见性 + } else { + lastSyncTimeView.setVisibility(View.GONE);//最近同步时间为空设置同步时间不可见 + } + } + } + + private void refreshUI() {//刷新标签界面 + loadAccountPreference(); + loadSyncButton();//加载“保存”按钮 + } + + private void showSelectAccountAlertDialog() {//显示账户选择的对话框并进行账户的设置 + AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);//创建一个新的对话框 + + View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null); + TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title); + titleTextView.setText(getString(R.string.preferences_dialog_select_account_title)); + TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);//文本试图设置 + subtitleTextView.setText(getString(R.string.preferences_dialog_select_account_tips)); + + dialogBuilder.setCustomTitle(titleView);//设置标题以及子标题的内容 + dialogBuilder.setPositiveButton(null, null);//不设置“确定”的按钮 + + Account[] accounts = getGoogleAccounts();//获得谷歌账户 + String defAccount = getSyncAccountName(this);//默认的账户 + + mOriAccounts = accounts;//获取同步账户信息 + mHasAddedAccount = false; + + if (accounts.length > 0) {//若账户不为空 + CharSequence[] items = new CharSequence[accounts.length]; + final CharSequence[] itemMapping = items; + int checkedItem = -1; + int index = 0; + for (Account account : accounts) {//通过循环检查账户列表 + if (TextUtils.equals(account.name, defAccount)) { + checkedItem = index; + }//在账户列表中查询到所需账户 + items[index++] = account.name; + } + dialogBuilder.setSingleChoiceItems(items, checkedItem,//在对话框建立一个单选的复选框 + new DialogInterface.OnClickListener() { + public void onClick(DialogInterface dialog, int which) {//响应对话框的点击，添加点击监听器，并完成一些操作 + setSyncAccount(itemMapping[which].toString());//点击则开始设置同步账户 + dialog.dismiss();//取消对话框 + refreshUI();//刷新界面 + } + }); + } + + View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);//视图，添加新的账户 + dialogBuilder.setView(addAccountView);//设置“添加账户”的视图 + + final AlertDialog dialog = dialogBuilder.show();//显示对话框 + addAccountView.setOnClickListener(new View.OnClickListener() {//设置监听器 + public void onClick(View v) {//响应点击添加账户的请求 + mHasAddedAccount = true;//将新加账户的hash置为true + Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");//建立网络建立组件 + intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] { + "gmail-ls" + }); + startActivityForResult(intent, -1);//跳回上一个选项 + dialog.dismiss(); + } + }); + } + + private void showChangeAccountConfirmAlertDialog() {//刷新标签界面 + AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);//创建一个新的对话框 + + View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null); + TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title); + titleTextView.setText(getString(R.string.preferences_dialog_change_account_title, + getSyncAccountName(this))); + TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle); + subtitleTextView.setText(getString(R.string.preferences_dialog_change_account_warn_msg)); + dialogBuilder.setCustomTitle(titleView); + + CharSequence[] menuItemArray = new CharSequence[] {//设置对话框的自定义标题 + getString(R.string.preferences_menu_change_account), + getString(R.string.preferences_menu_remove_account), + getString(R.string.preferences_menu_cancel) + }; + dialogBuilder.setItems(menuItemArray, new DialogInterface.OnClickListener() {//定义一些标记字符串 + public void onClick(DialogInterface dialog, int which) {//设置对话框要显示的一个list，用于显示几个命令时,即change，remove，cancel + if (which == 0) {//进入账户选择对话框 + showSelectAccountAlertDialog();//显示账户选择提示对话框 + } else if (which == 1) {//删除同步账户 + removeSyncAccount();//删除账户并且跟新便签界面 + refreshUI(); + } + } + }); + dialogBuilder.show();//显示对话框 + } + + private Account[] getGoogleAccounts() {//获取谷歌账户，可通过账户管理器直接获取 + AccountManager accountManager = AccountManager.get(this); + return accountManager.getAccountsByType("com.google"); + } + + private void setSyncAccount(String account) {//设置同步账户 + if (!getSyncAccountName(this).equals(account)) {//如果该账号不在同步账号列表中 + SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE); + SharedPreferences.Editor editor = settings.edit();//编辑共享首选项 + if (account != null) {//编辑共享的首选项 + editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, account); + } else { + editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, ""); + }//将该账号加入到首选项中 + editor.commit();//提交修改的数据 + + // clean up last sync time + setLastSyncTime(this, 0);//将最后同步时间清零 + + // clean up local gtask related info + new Thread(new Runnable() {// 新线程的创建 + public void run() {//清除本地的gtask关联的信息 + ContentValues values = new ContentValues(); + values.put(NoteColumns.GTASK_ID, ""); + values.put(NoteColumns.SYNC_ID, 0); + getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null); + } + }).start();//重置当地同步任务的信息 + + Toast.makeText(NotesPreferenceActivity.this,//设置一个toast提示信息，提示用户成功设置同步 + getString(R.string.preferences_toast_success_set_accout, account), + Toast.LENGTH_SHORT).show();//将toast的文本信息置为“设置账户成功”并显示出来 + } + } + + private void removeSyncAccount() {//删除同步账户 + SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);//SharedPreferences是以键值对的形式存储数据的，其使用非常简单，能够轻松的存放数据和读取数据 + SharedPreferences.Editor editor = settings.edit();//设置共享首选项 + if (settings.contains(PREFERENCE_SYNC_ACCOUNT_NAME)) {//假如当前首选项中有账户就删除 + editor.remove(PREFERENCE_SYNC_ACCOUNT_NAME); + } + if (settings.contains(PREFERENCE_LAST_SYNC_TIME)) {//删除当前首选项中有账户时间 + editor.remove(PREFERENCE_LAST_SYNC_TIME);//如果包含其中就将时间也清除 + } + editor.commit();//提交更新后的数据 + + // clean up local gtask related info + new Thread(new Runnable() {//新线程的创建 + public void run() {//清除本地的gtask关联的信息，将一些参数设置为0或NULL + ContentValues values = new ContentValues(); + values.put(NoteColumns.GTASK_ID, ""); + values.put(NoteColumns.SYNC_ID, 0); + getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null); + } + }).start(); + } + + public static String getSyncAccountName(Context context) {//获取同步账户名称，通过共享的首选项里的信息直接获取 + SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME, + Context.MODE_PRIVATE);//获取同步账户名称 + return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, ""); + } + + public static void setLastSyncTime(Context context, long time) {//设置最终同步的时间 + SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME, + Context.MODE_PRIVATE); + SharedPreferences.Editor editor = settings.edit();//从共享首选项中找到相关账户并获取其编辑器 + editor.putLong(PREFERENCE_LAST_SYNC_TIME, time); + editor.commit();//编辑最终同步时间并提交更新 + } + + public static long getLastSyncTime(Context context) {//获取最终同步时间 + SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME, + Context.MODE_PRIVATE);//通过共享，获取时间 + return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0); + } + + private class GTaskReceiver extends BroadcastReceiver {//接受同步信息 + + @Override + public void onReceive(Context context, Intent intent) {//刷新界面，判断是否同步状态下 + refreshUI(); + if (intent.getBooleanExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING, false)) {//：获取随广播而来的Intent中的同步服务的数据 + TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);//通过获取的数据在设置系统的状态 + syncStatus.setText(intent + .getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG)); + }//通过获取的数据在设置系统的状态 + + } + } + + public boolean onOptionsItemSelected(MenuItem item) {//处理菜单的选项 + switch (item.getItemId()) {//根据选项的id选择，这里只有一个主页 + case android.R.id.home://返回主界面 + Intent intent = new Intent(this, NotesListActivity.class); + intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP); + startActivity(intent);//创建活动 + return true; + default://在主页情况下在创建连接组件intent，发出清空的信号并开始一个相应的activity + return false; + } + } +} diff --git a/src/notes/widget/NoteWidgetProvider.java b/src/notes/widget/NoteWidgetProvider.java new file mode 100644 index 0000000..97e7365 --- /dev/null +++ b/src/notes/widget/NoteWidgetProvider.java @@ -0,0 +1,132 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.widget;//导入widget +import android.app.PendingIntent;//引入各种类 +import android.appwidget.AppWidgetManager;//导入AppWidget +import android.appwidget.AppWidgetProvider;//提供widget的基本操作和属性 +import android.content.ContentValues; +import android.content.Context; +import android.content.Intent; +import android.database.Cursor;//数据库的光标 +import android.util.Log; +import android.widget.RemoteViews;//远程访问 + +import net.micode.notes.R;//引入android自动生成的R类资源 +import net.micode.notes.data.Notes; +import net.micode.notes.data.Notes.NoteColumns;//便签栏 +import net.micode.notes.tool.ResourceParser; +import net.micode.notes.ui.NoteEditActivity; +import net.micode.notes.ui.NotesListActivity; + +public abstract class NoteWidgetProvider extends AppWidgetProvider {//构造了一个类继承Android原有的AppWidgetProvider类 + public static final String [] PROJECTION = new String [] {//定义了一个字符数组类型的静态变量 + NoteColumns.ID, + NoteColumns.BG_COLOR_ID, + NoteColumns.SNIPPET + }; + + public static final int COLUMN_ID = 0;//便签栏编号 + public static final int COLUMN_BG_COLOR_ID = 1;//背景颜色编号 + public static final int COLUMN_SNIPPET = 2;//便签片段 + + private static final String TAG = "NoteWidgetProvider";//定义NoteWidgetProvider为标签TAG + + @Override + public void onDeleted(Context context, int[] appWidgetIds) {//重载删除方法，把WIDGET_ID置为INVALID_APPPWIDGET_ID,把当前窗口ID置为无效， + ContentValues values = new ContentValues();//定义了一个新values变量 + values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);//存储便签信息 + for (int i = 0; i < appWidgetIds.length; i++) {//遍历修改所有的URI值 + context.getContentResolver().update(Notes.CONTENT_NOTE_URI, + values, + NoteColumns.WIDGET_ID + "=?", + new String[] { String.valueOf(appWidgetIds[i])});// valueOf() 方法用于返回给定参数的原生 Number 对象值 + } + } + + private Cursor getNoteWidgetInfo(Context context, int widgetId) {//获取窗口宽度信息 + return context.getContentResolver().query(Notes.CONTENT_NOTE_URI,//返回信息值 + PROJECTION, + NoteColumns.WIDGET_ID + "=? AND " + NoteColumns.PARENT_ID + "<>?",//用ID来筛选，同时要是存在于未被删除的文件夹中 + new String[] { String.valueOf(widgetId), String.valueOf(Notes.ID_TRASH_FOLER) }, + null); + } + + protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {//上传widget的信息 + update(context, appWidgetManager, appWidgetIds, false);//更新窗口部件 + } + + private void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds,//把更新的窗口ID保存到窗口管理器中 + boolean privacyMode) { + for (int i = 0; i < appWidgetIds.length; i++) {//每添加一个widget就会进行一次循环更新操作 + if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) {//需要跳过那些已经关闭的窗口的ID + int bgId = ResourceParser.getDefaultBgId(context); + String snippet = ""; + Intent intent = new Intent(context, NoteEditActivity.class);//创建intent对象 + intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);//目标activity在栈顶跳转，不在则新建一个 + intent.putExtra(Notes.INTENT_EXTRA_WIDGET_ID, appWidgetIds[i]);//将要传递的值附加键对象 + intent.putExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, getWidgetType());//附加组件类型 + + Cursor c = getNoteWidgetInfo(context, appWidgetIds[i]);//获取特定的对应对象 + if (c != null && c.moveToFirst()) {//处理多窗口同位置的情况 + if (c.getCount() > 1) {//cursor.getCount()返回cursor中的行数。 + Log.e(TAG, "Multiple message with same widget id:" + appWidgetIds[i]); + c.close(); + return; + } + snippet = c.getString(COLUMN_SNIPPET);//一条字符串 + bgId = c.getInt(COLUMN_BG_COLOR_ID);//获取ID值 + intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_ID));//目的 + intent.setAction(Intent.ACTION_VIEW);//为Intent设置一个动作Action + } else {//在Intent内设置一个Action + snippet = context.getResources().getString(R.string.widget_havenot_content);//没有关联内容，点击新建便签 + intent.setAction(Intent.ACTION_INSERT_OR_EDIT); + } + + if (c != null) { + c.close(); + } + + RemoteViews rv = new RemoteViews(context.getPackageName(), getLayoutId());//获取AppWidget对应的视图 + rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId));//根据当前的属性，设置背景图片 + intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId); + /** + * Generate the pending intent to start host for the widget//为小部件生成启动主机的挂起意图 + */ + PendingIntent pendingIntent = null;//为小部件生成启动主机的挂起的目标选项 + if (privacyMode) {//判定是否是私密模式 + rv.setTextViewText(R.id.widget_text,//访客模式下，便签内容不可见 + context.getString(R.string.widget_under_visit_mode)); + pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], new Intent( + context, NotesListActivity.class), PendingIntent.FLAG_UPDATE_CURRENT);//获得一个PendingIntent，如果该意图要发生就相当于Context.startActivity(Intent)。 + } else { + rv.setTextViewText(R.id.widget_text, snippet);//设置 点击“按钮(widget_text)”时会触发的Intent，从而对按钮点击事件进行处理 + pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], intent, + PendingIntent.FLAG_UPDATE_CURRENT); + } + + rv.setOnClickPendingIntent(R.id.widget_text, pendingIntent);//窗口服务部件 + appWidgetManager.updateAppWidget(appWidgetIds[i], rv);//调用集合管理器对集合进行更新 + } + } + } + + protected abstract int getBgResourceId(int bgId);//从背景资源中获取当前应用ID + + protected abstract int getLayoutId();//获取部局ID + + protected abstract int getWidgetType();//可以调用2*2或者4*4的函数 +} diff --git a/src/notes/widget/NoteWidgetProvider_2x.java b/src/notes/widget/NoteWidgetProvider_2x.java new file mode 100644 index 0000000..0ca073a --- /dev/null +++ b/src/notes/widget/NoteWidgetProvider_2x.java @@ -0,0 +1,47 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.widget;//声明小米便签窗口部件这个包 + +import android.appwidget.AppWidgetManager;//使用AppWidgetManager这个类 +import android.content.Context; + +import net.micode.notes.R; +import net.micode.notes.data.Notes;//便签数据 +import net.micode.notes.tool.ResourceParser;//资源解析器 + + +public class NoteWidgetProvider_2x extends NoteWidgetProvider {//继承NoteWidgetProvider这个类 + @Override + public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {//更新窗口 + super.update(context, appWidgetManager, appWidgetIds); + } + + @Override + protected int getLayoutId() { + return R.layout.widget_2x; + }//获取窗口布局 + + @Override + protected int getBgResourceId(int bgId) {//获取背景颜色id + return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId); + } + + @Override + protected int getWidgetType() { + return Notes.TYPE_WIDGET_2X; + }//确定窗口大小 +} diff --git a/src/notes/widget/NoteWidgetProvider_4x.java b/src/notes/widget/NoteWidgetProvider_4x.java new file mode 100644 index 0000000..1f60b05 --- /dev/null +++ b/src/notes/widget/NoteWidgetProvider_4x.java @@ -0,0 +1,46 @@ +/* + * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package net.micode.notes.widget;//声明包名 + +import android.appwidget.AppWidgetManager;//导入一些类 +import android.content.Context; + +import net.micode.notes.R; +import net.micode.notes.data.Notes; +import net.micode.notes.tool.ResourceParser; + + +public class NoteWidgetProvider_4x extends NoteWidgetProvider {//定义4*4的widget + @Override + public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {//对窗口更新进行重载 + super.update(context, appWidgetManager, appWidgetIds); + } + + protected int getLayoutId() { + return R.layout.widget_4x; + }//返回窗口位置信息，返回了小米便签挂件是2x2型 + + @Override + protected int getBgResourceId(int bgId) {// 获取背景颜色ID + return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId);//返回了小米便签2x2型挂件的背景类型ID，即确定了2x2型的背景。 + } + + @Override + protected int getWidgetType() { + return Notes.TYPE_WIDGET_4X; + }//返回窗口类型 +}