#199

完成社区同步更新博客（issue 描述里的第一点：1. 提供文章更新接口给社区）

core/src/main/java/org/b3log/solo/api/symphony/ArticleReceiver.java

@@ -33,6 +33,7 @@ import org.b3log.solo.model.Article;
 import org.b3log.solo.model.Common;
 import org.b3log.solo.model.Preference;
 import org.b3log.solo.service.ArticleMgmtService;
+import org.b3log.solo.service.ArticleQueryService;
 import org.b3log.solo.service.PreferenceQueryService;
 import org.b3log.solo.service.UserQueryService;
 import org.b3log.solo.util.QueryResults;
@@ -44,7 +45,7 @@ import org.jsoup.Jsoup;
  * Article receiver (from B3log Symphony).
  *
  * @author <a href="mailto:DL88250@gmail.com">Liang Ding</a>
- * @version 1.0.0.4, Jan 4, 2013
+ * @version 1.0.0.5, Mar 18, 2013
  * @since 0.5.5
  */
 @RequestProcessor
@@ -65,6 +66,11 @@ public final class ArticleReceiver {
      */
     private ArticleMgmtService articleMgmtService = ArticleMgmtService.getInstance();
 
+    /**
+     * Article query service.
+     */
+    private ArticleQueryService articleQueryService = ArticleQueryService.getInstance();
+
     /**
      * Article abstract length.
      */
@@ -101,7 +107,7 @@ public final class ArticleReceiver {
      * @param context the specified http request context
      * @throws Exception exception
      */
-    @RequestProcessing(value = "/apis/symphony/article", method = HTTPRequestMethod.PUT)
+    @RequestProcessing(value = "/apis/symphony/article", method = HTTPRequestMethod.POST)
     public void addArticle(final HttpServletRequest request, final HttpServletResponse response, final HTTPRequestContext context)
         throws Exception {
         final JSONRenderer renderer = new JSONRenderer();
@@ -142,7 +148,7 @@ public final class ArticleReceiver {
             final String articleId = article.getString(Keys.OBJECT_ID);
 
             content += "<br/><br/><p style='font-size: 12px;'><i>该文章同步自 <a href='http://symphony.b3log.org/article/" + articleId
-                + "' target='_blank>B3log 社区</a></i></p>";
+                + "' target='_blank'>B3log 社区</a></i></p>";
             article.put(Article.ARTICLE_CONTENT, content);
 
             articleMgmtService.addArticle(requestJSONObject);
@@ -161,4 +167,98 @@ public final class ArticleReceiver {
             jsonObject.put(Keys.MSG, e.getMessage());
         }
     }
+
+    /**
+     * Updates an article with the specified request.
+     *
+     * <p>
+     * Renders the response with a json object, for example,
+     * <pre>
+     * {
+     *     "sc": boolean,
+     *     "msg": ""
+     * }
+     * </pre>
+     * </p>
+     *
+     * @param request the specified http servlet request, for example,
+     * <pre>
+     * {
+     *     "article": {
+     *         "oId": "", // Symphony Article#clientArticleId
+     *         "articleTitle": "",
+     *         "articleContent": "",
+     *         "articleTags": "tag1,tag2,tag3",
+     *         "userB3Key": "",
+     *         "articleEditorType": ""
+     *     }
+     * }
+     * </pre>
+     * @param response the specified http servlet response
+     * @param context the specified http request context
+     * @throws Exception exception
+     */
+    @RequestProcessing(value = "/apis/symphony/article", method = HTTPRequestMethod.PUT)
+    public void updateArticle(final HttpServletRequest request, final HttpServletResponse response, final HTTPRequestContext context)
+        throws Exception {
+        final JSONRenderer renderer = new JSONRenderer();
+
+        context.setRenderer(renderer);
+
+        final JSONObject ret = new JSONObject();
+
+        renderer.setJSONObject(ret);
+
+        try {
+            final JSONObject requestJSONObject = Requests.parseRequestJSONObject(request, response);
+            final JSONObject article = requestJSONObject.optJSONObject(Article.ARTICLE);
+            final String userB3Key = article.optString("userB3Key");
+            final JSONObject preference = preferenceQueryService.getPreference();
+
+            if (!userB3Key.equals(preference.optString(Preference.KEY_OF_SOLO))) {
+                LOGGER.log(Level.WARNING, "B3 key not match, ignored update article");
+
+                return;
+            }
+            article.remove("userB3Key");
+
+            final String articleId = article.getString(Keys.OBJECT_ID);
+
+            if (null == articleQueryService.getArticleById(articleId)) {
+                ret.put(Keys.MSG, "No found article[oId=" + articleId + "] to update");
+                ret.put(Keys.STATUS_CODE, false);
+
+                return;
+            }
+
+            final String plainTextContent = Jsoup.parse(article.optString(Article.ARTICLE_CONTENT)).text();
+
+            if (plainTextContent.length() > ARTICLE_ABSTRACT_LENGTH) {
+                article.put(Article.ARTICLE_ABSTRACT, plainTextContent.substring(0, ARTICLE_ABSTRACT_LENGTH) + "....");
+            } else {
+                article.put(Article.ARTICLE_ABSTRACT, plainTextContent);
+            }
+            article.put(Article.ARTICLE_IS_PUBLISHED, true);
+            article.put(Common.POST_TO_COMMUNITY, false); // Do not send to rhythm
+            article.put(Article.ARTICLE_COMMENTABLE, true);
+            article.put(Article.ARTICLE_VIEW_PWD, "");
+            String content = article.getString(Article.ARTICLE_CONTENT);
+
+            content += "<br/><br/><p style='font-size: 12px;'><i>该文章同步自 <a href='http://symphony.b3log.org/article/" + articleId
+                + "' target='_blank'>B3log 社区</a></i></p>";
+            article.put(Article.ARTICLE_CONTENT, content);
+
+            articleMgmtService.updateArticle(requestJSONObject);
+
+            ret.put(Keys.MSG, "update article succ");
+            ret.put(Keys.STATUS_CODE, true);
+        } catch (final ServiceException e) {
+            LOGGER.log(Level.SEVERE, e.getMessage(), e);
+
+            final JSONObject jsonObject = QueryResults.defaultResult();
+
+            renderer.setJSONObject(jsonObject);
+            jsonObject.put(Keys.MSG, e.getMessage());
+        }
+    }
 }

core/src/main/java/org/b3log/solo/processor/LoginProcessor.java

@@ -15,6 +15,7 @@
  */
 package org.b3log.solo.processor;
 
+
 import java.io.IOException;
 import java.util.Calendar;
 import java.util.Map;
@@ -54,6 +55,7 @@ import org.b3log.solo.util.Randoms;
 import org.json.JSONException;
 import org.json.JSONObject;
 
+
 /**
  * Login/logout processor.
  *
@@ -72,30 +74,37 @@ public final class LoginProcessor {
      * Logger.
      */
     private static final Logger LOGGER = Logger.getLogger(LoginProcessor.class.getName());
+
     /**
      * User query service.
      */
     private static UserQueryService userQueryService = UserQueryService.getInstance();
+
     /**
      * User service.
      */
     private UserService userService = UserServiceFactory.getUserService();
+
     /**
      * Mail service.
      */
     private MailService mailService = MailServiceFactory.getMailService();
+
     /**
      * User management service.
      */
     private UserMgmtService userMgmtService = UserMgmtService.getInstance();
+
     /**
      * Language service.
      */
     private LangPropsService langPropsService = LangPropsService.getInstance();
+
     /**
      * Filler.
      */
     private Filler filler = Filler.getInstance();
+
     /**
      * Preference query service.
      */
@@ -142,7 +151,7 @@ public final class LoginProcessor {
      *
      * @param context the specified context
      */
-    @RequestProcessing(value = {"/login"}, method = HTTPRequestMethod.POST)
+    @RequestProcessing(value = { "/login"}, method = HTTPRequestMethod.POST)
     public void login(final HTTPRequestContext context) {
         final HttpServletRequest request = context.getRequest();
 
@@ -200,7 +209,7 @@ public final class LoginProcessor {
      * @param context the specified context
      * @throws IOException io exception
      */
-    @RequestProcessing(value = {"/logout"}, method = HTTPRequestMethod.GET)
+    @RequestProcessing(value = { "/logout"}, method = HTTPRequestMethod.GET)
     public void logout(final HTTPRequestContext context) throws IOException {
         final HttpServletRequest httpServletRequest = context.getRequest();
 
@@ -249,7 +258,7 @@ public final class LoginProcessor {
      *
      * @param context the specified context
      */
-    @RequestProcessing(value = {"/forgot"}, method = HTTPRequestMethod.POST)
+    @RequestProcessing(value = { "/forgot"}, method = HTTPRequestMethod.POST)
     public void forgot(final HTTPRequestContext context) {
         final HttpServletRequest request = context.getRequest();
 
@@ -376,7 +385,8 @@ public final class LoginProcessor {
         final String mailSubject = langPropsService.get("resetPwdMailSubject");
         final String mailBody = langPropsService.get("resetPwdMailBody") + randomPwd;
         final MailService.Message message = new MailService.Message();
-        //FIXME whether we should put the ever-hashed password here, rather during updating?
+
+        // FIXME whether we should put the ever-hashed password here, rather during updating?
         user.put(User.USER_PASSWORD, randomPwd);
         userMgmtService.updateUser(user);
 
@@ -391,8 +401,7 @@ public final class LoginProcessor {
         jsonObject.put("to", Latkes.getServePath() + "/login");
         jsonObject.put(Keys.MSG, langPropsService.get("resetPwdSuccessMsg"));
 
-        LOGGER.log(Level.FINER, "Sending a mail[mailSubject={0}, mailBody=[{1}] to [{2}]",
-                new Object[]{mailSubject, mailBody, userEmail});
+        LOGGER.log(Level.FINER, "Sending a mail[mailSubject={0}, mailBody=[{1}] to [{2}]", new Object[] {mailSubject, mailBody, userEmail});
     }
 
     /**

core/src/main/java/org/b3log/solo/util/Permalinks.java

-/*
- * Copyright (c) 2009, 2010, 2011, 2012, 2013, B3log Team
- *
- * 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 org.b3log.solo.util;
-
-
-import java.util.logging.Level;
-import java.util.logging.Logger;
-import java.util.regex.Matcher;
-import java.util.regex.Pattern;
-import org.b3log.latke.repository.RepositoryException;
-import org.b3log.latke.util.Strings;
-import org.b3log.solo.repository.ArticleRepository;
-import org.b3log.solo.repository.PageRepository;
-import org.b3log.solo.repository.impl.ArticleRepositoryImpl;
-import org.b3log.solo.repository.impl.PageRepositoryImpl;
-
-
-/**
- * Permalink utilities.
- *
- * @author <a href="mailto:DL88250@gmail.com">Liang Ding</a>
- * @version 1.1.0.8, Aug 22, 2012
- * @since 0.3.1
- */
-public final class Permalinks {
-
-    /**
-     * Logger.
-     */
-    private static final Logger LOGGER = Logger.getLogger(Permalinks.class.getName());
-
-    /**
-     * Article repository.
-     */
-    private ArticleRepository articleRepository = ArticleRepositoryImpl.getInstance();
-
-    /**
-     * Page repository.
-     */
-    private PageRepository pageRepository = PageRepositoryImpl.getInstance();
-
-    /**
-     * Reserved permalinks.
-     */
-    public static final String[] RESERVED_LINKS = new String[] {
-        "/", "/article", "/tags.html", "/tags", "/page", "/blog-articles-feed.do", "/tag-articles-feed.do", "/blog-articles-rss.do",
-        "/tag-articles-rss.do", "/get-random-articles.do", "/article-random-double-gen.do", "/captcha.do", "/kill-browser.html",
-        "/add-article-comment.do", "/add-article-from-symphony-comment.do", "/add-page-comment.do", "/get-article-content", "/sitemap.xml",
-        "/login", "/logout", "/forgot", "/get-article-content", "/admin-index.do", "/admin-article.do", "/admin-article-list.do", "/admin-link-list.do",
-        "/admin-preference.do", "/admin-file-list.do", "/admin-page-list.do", "/admin-others.do", "/admin-draft-list.do",
-        "/admin-user-list.do", "/admin-plugin-list.do", "/admin-main.do", "/admin-about.do", "/admin-label", "/admin-about.do",
-        "/rm-all-data.do", "/init", "/clear-cache.do",
-    };
-
-    /**
-     * Checks whether the specified article permalink matches the system 
-     * generated format pattern ("/articles/yyyy/MM/dd/${articleId}.html").
-     * 
-     * @param permalink the specified permalink
-     * @return {@code true} if matches, returns {@code false} otherwise
-     */
-    public static boolean matchDefaultArticlePermalinkFormat(final String permalink) {
-        final Pattern pattern = Pattern.compile("/articles/\\d{4}/\\d{2}/\\d{2}/\\d+\\.html");
-        final Matcher matcher = pattern.matcher(permalink);
-
-        return matcher.matches();
-    }
-
-    /**
-     * Checks whether the specified page permalink matches the system generated 
-     * format pattern ("/pages/${pageId}.html").
-     * 
-     * @param permalink the specified permalink
-     * @return {@code true} if matches, returns {@code false} otherwise
-     */
-    public static boolean matchDefaultPagePermalinkFormat(final String permalink) {
-        final Pattern pattern = Pattern.compile("/pages/\\d+\\.html");
-        final Matcher matcher = pattern.matcher(permalink);
-
-        return matcher.matches();
-    }
-
-    /**
-     * Checks whether the specified permalink is a
-     * {@link #invalidArticlePermalinkFormat(java.lang.String) invalid article 
-     * permalink format} and {@link #invalidPagePermalinkFormat(java.lang.String) 
-     * invalid page permalink format}.
-     * 
-     * @param permalink the specified permalink
-     * @return {@code true} if invalid, returns {@code false} otherwise 
-     */
-    public static boolean invalidPermalinkFormat(final String permalink) {
-        return invalidArticlePermalinkFormat(permalink) && invalidPagePermalinkFormat(permalink);
-    }
-
-    /**
-     * Checks whether the specified article permalink is invalid on format.
-     * 
-     * @param permalink the specified article permalink
-     * @return {@code true} if invalid, returns {@code false} otherwise
-     */
-    public static boolean invalidArticlePermalinkFormat(final String permalink) {
-        if (Strings.isEmptyOrNull(permalink)) {
-            return true;
-        }
-
-        if (matchDefaultArticlePermalinkFormat(permalink)) {
-            return false;
-        }
-
-        return invalidUserDefinedPermalinkFormat(permalink);
-    }
-
-    /**
-     * Checks whether the specified page permalink is invalid on format.
-     * 
-     * @param permalink the specified page permalink
-     * @return {@code true} if invalid, returns {@code false} otherwise
-     */
-    public static boolean invalidPagePermalinkFormat(final String permalink) {
-        if (Strings.isEmptyOrNull(permalink)) {
-            return true;
-        }
-
-        if (matchDefaultPagePermalinkFormat(permalink)) {
-            return false;
-        }
-
-        return invalidUserDefinedPermalinkFormat(permalink);
-    }
-
-    /**
-     * Checks whether the specified user-defined permalink is invalid on format.
-     * 
-     * @param permalink the specified user-defined permalink
-     * @return {@code true} if invalid, returns {@code false} otherwise
-     */
-    private static boolean invalidUserDefinedPermalinkFormat(
-        final String permalink) {
-        if (Strings.isEmptyOrNull(permalink)) {
-            return true;
-        }
-
-        if (isReservedLink(permalink)) {
-            return true;
-        }
-
-        if (Strings.isNumeric(permalink.substring(1))) {
-            // See issue 120 (http://code.google.com/p/b3log-solo/issues/detail?id=120#c4)
-            // for more details
-            return true;
-        }
-
-        int slashCnt = 0;
-
-        for (int i = 0; i < permalink.length(); i++) {
-            if ('/' == permalink.charAt(i)) {
-                slashCnt++;
-            }
-
-            if (slashCnt > 1) {
-                return true;
-            }
-        }
-
-        // FIXME: URL format check
-
-        return false;
-    }
-
-    /**
-     * Determines whether the specified request URI is a reserved link.
-     * 
-     * <p>
-     * A URI starts with one of {@link Permalinks#RESERVED_LINKS reserved links}
-     * will be treated as reserved link.
-     * </p>
-     * 
-     * @param requestURI the specified request URI
-     * @return {@code true} if it is a reserved link, returns {@code false}
-     * otherwise
-     */
-    private static boolean isReservedLink(final String requestURI) {
-        for (int i = 0; i < Permalinks.RESERVED_LINKS.length; i++) {
-            final String reservedLink = Permalinks.RESERVED_LINKS[i];
-
-            if (reservedLink.startsWith(requestURI)) {
-
-                return true;
-            }
-        }
-
-        return false;
-    }
-
-    /**
-     * Determines whether the specified permalink exists.
-     *
-     * @param permalink the specified permalink
-     * @return {@code true} if exists, returns {@code false} otherwise
-     */
-    public boolean exist(final String permalink) {
-        try {
-            return isReservedLink(permalink) || null != articleRepository.getByPermalink(permalink)
-                || null != pageRepository.getByPermalink(permalink) || permalink.endsWith(".ftl");
-        } catch (final RepositoryException e) {
-            LOGGER.log(Level.SEVERE, "Determines whether the permalink[" + permalink + "] exists failed, returns true", e);
-
-            return true;
-        }
-    }
-
-    /**
-     * Gets the {@link Permalinks} singleton.
-     *
-     * @return the singleton
-     */
-    public static Permalinks getInstance() {
-        return SingletonHolder.SINGLETON;
-    }
-
-    /**
-     * Private default constructor.
-     */
-    private Permalinks() {}
-
-    /**
-     * Singleton holder.
-     *
-     * @author <a href="mailto:DL88250@gmail.com">Liang Ding</a>
-     * @version 1.0.0.0, Jan 12, 2011
-     */
-    private static final class SingletonHolder {
-
-        /**
-         * Singleton.
-         */
-        private static final Permalinks SINGLETON = new Permalinks();
-
-        /**
-         * Private default constructor.
-         */
-        private SingletonHolder() {}
-    }
-}
+/*
+ * Copyright (c) 2009, 2010, 2011, 2012, 2013, B3log Team
+ *
+ * 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 org.b3log.solo.util;
+
+
+import java.util.logging.Level;
+import java.util.logging.Logger;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+import org.b3log.latke.repository.RepositoryException;
+import org.b3log.latke.util.Strings;
+import org.b3log.solo.repository.ArticleRepository;
+import org.b3log.solo.repository.PageRepository;
+import org.b3log.solo.repository.impl.ArticleRepositoryImpl;
+import org.b3log.solo.repository.impl.PageRepositoryImpl;
+
+
+/**
+ * Permalink utilities.
+ *
+ * @author <a href="mailto:DL88250@gmail.com">Liang Ding</a>
+ * @version 1.1.0.8, Aug 22, 2012
+ * @since 0.3.1
+ */
+public final class Permalinks {
+
+    /**
+     * Logger.
+     */
+    private static final Logger LOGGER = Logger.getLogger(Permalinks.class.getName());
+
+    /**
+     * Article repository.
+     */
+    private ArticleRepository articleRepository = ArticleRepositoryImpl.getInstance();
+
+    /**
+     * Page repository.
+     */
+    private PageRepository pageRepository = PageRepositoryImpl.getInstance();
+
+    /**
+     * Reserved permalinks.
+     */
+    public static final String[] RESERVED_LINKS = new String[] {
+        "/", "/article", "/tags.html", "/tags", "/page", "/blog-articles-feed.do", "/tag-articles-feed.do", "/blog-articles-rss.do",
+        "/tag-articles-rss.do", "/get-random-articles.do", "/article-random-double-gen.do", "/captcha.do", "/kill-browser.html",
+        "/add-article-comment.do", "/add-article-from-symphony-comment.do", "/add-page-comment.do", "/get-article-content", "/sitemap.xml",
+        "/login", "/logout", "/forgot", "/get-article-content", "/admin-index.do", "/admin-article.do", "/admin-article-list.do",
+        "/admin-link-list.do", "/admin-preference.do", "/admin-file-list.do", "/admin-page-list.do", "/admin-others.do",
+        "/admin-draft-list.do", "/admin-user-list.do", "/admin-plugin-list.do", "/admin-main.do", "/admin-about.do", "/admin-label",
+        "/admin-about.do", "/rm-all-data.do", "/init", "/clear-cache.do",
+    };
+
+    /**
+     * Checks whether the specified article permalink matches the system 
+     * generated format pattern ("/articles/yyyy/MM/dd/${articleId}.html").
+     * 
+     * @param permalink the specified permalink
+     * @return {@code true} if matches, returns {@code false} otherwise
+     */
+    public static boolean matchDefaultArticlePermalinkFormat(final String permalink) {
+        final Pattern pattern = Pattern.compile("/articles/\\d{4}/\\d{2}/\\d{2}/\\d+\\.html");
+        final Matcher matcher = pattern.matcher(permalink);
+
+        return matcher.matches();
+    }
+
+    /**
+     * Checks whether the specified page permalink matches the system generated 
+     * format pattern ("/pages/${pageId}.html").
+     * 
+     * @param permalink the specified permalink
+     * @return {@code true} if matches, returns {@code false} otherwise
+     */
+    public static boolean matchDefaultPagePermalinkFormat(final String permalink) {
+        final Pattern pattern = Pattern.compile("/pages/\\d+\\.html");
+        final Matcher matcher = pattern.matcher(permalink);
+
+        return matcher.matches();
+    }
+
+    /**
+     * Checks whether the specified permalink is a
+     * {@link #invalidArticlePermalinkFormat(java.lang.String) invalid article 
+     * permalink format} and {@link #invalidPagePermalinkFormat(java.lang.String) 
+     * invalid page permalink format}.
+     * 
+     * @param permalink the specified permalink
+     * @return {@code true} if invalid, returns {@code false} otherwise 
+     */
+    public static boolean invalidPermalinkFormat(final String permalink) {
+        return invalidArticlePermalinkFormat(permalink) && invalidPagePermalinkFormat(permalink);
+    }
+
+    /**
+     * Checks whether the specified article permalink is invalid on format.
+     * 
+     * @param permalink the specified article permalink
+     * @return {@code true} if invalid, returns {@code false} otherwise
+     */
+    public static boolean invalidArticlePermalinkFormat(final String permalink) {
+        if (Strings.isEmptyOrNull(permalink)) {
+            return true;
+        }
+
+        if (matchDefaultArticlePermalinkFormat(permalink)) {
+            return false;
+        }
+
+        return invalidUserDefinedPermalinkFormat(permalink);
+    }
+
+    /**
+     * Checks whether the specified page permalink is invalid on format.
+     * 
+     * @param permalink the specified page permalink
+     * @return {@code true} if invalid, returns {@code false} otherwise
+     */
+    public static boolean invalidPagePermalinkFormat(final String permalink) {
+        if (Strings.isEmptyOrNull(permalink)) {
+            return true;
+        }
+
+        if (matchDefaultPagePermalinkFormat(permalink)) {
+            return false;
+        }
+
+        return invalidUserDefinedPermalinkFormat(permalink);
+    }
+
+    /**
+     * Checks whether the specified user-defined permalink is invalid on format.
+     * 
+     * @param permalink the specified user-defined permalink
+     * @return {@code true} if invalid, returns {@code false} otherwise
+     */
+    private static boolean invalidUserDefinedPermalinkFormat(
+        final String permalink) {
+        if (Strings.isEmptyOrNull(permalink)) {
+            return true;
+        }
+
+        if (isReservedLink(permalink)) {
+            return true;
+        }
+
+        if (Strings.isNumeric(permalink.substring(1))) {
+            // See issue 120 (http://code.google.com/p/b3log-solo/issues/detail?id=120#c4)
+            // for more details
+            return true;
+        }
+
+        int slashCnt = 0;
+
+        for (int i = 0; i < permalink.length(); i++) {
+            if ('/' == permalink.charAt(i)) {
+                slashCnt++;
+            }
+
+            if (slashCnt > 1) {
+                return true;
+            }
+        }
+
+        // FIXME: URL format check
+
+        return false;
+    }
+
+    /**
+     * Determines whether the specified request URI is a reserved link.
+     * 
+     * <p>
+     * A URI starts with one of {@link Permalinks#RESERVED_LINKS reserved links}
+     * will be treated as reserved link.
+     * </p>
+     * 
+     * @param requestURI the specified request URI
+     * @return {@code true} if it is a reserved link, returns {@code false}
+     * otherwise
+     */
+    private static boolean isReservedLink(final String requestURI) {
+        for (int i = 0; i < Permalinks.RESERVED_LINKS.length; i++) {
+            final String reservedLink = Permalinks.RESERVED_LINKS[i];
+
+            if (reservedLink.startsWith(requestURI)) {
+
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * Determines whether the specified permalink exists.
+     *
+     * @param permalink the specified permalink
+     * @return {@code true} if exists, returns {@code false} otherwise
+     */
+    public boolean exist(final String permalink) {
+        try {
+            return isReservedLink(permalink) || null != articleRepository.getByPermalink(permalink)
+                || null != pageRepository.getByPermalink(permalink) || permalink.endsWith(".ftl");
+        } catch (final RepositoryException e) {
+            LOGGER.log(Level.SEVERE, "Determines whether the permalink[" + permalink + "] exists failed, returns true", e);
+
+            return true;
+        }
+    }
+
+    /**
+     * Gets the {@link Permalinks} singleton.
+     *
+     * @return the singleton
+     */
+    public static Permalinks getInstance() {
+        return SingletonHolder.SINGLETON;
+    }
+
+    /**
+     * Private default constructor.
+     */
+    private Permalinks() {}
+
+    /**
+     * Singleton holder.
+     *
+     * @author <a href="mailto:DL88250@gmail.com">Liang Ding</a>
+     * @version 1.0.0.0, Jan 12, 2011
+     */
+    private static final class SingletonHolder {
+
+        /**
+         * Singleton.
+         */
+        private static final Permalinks SINGLETON = new Permalinks();
+
+        /**
+         * Private default constructor.
+         */
+        private SingletonHolder() {}
+    }
+}

core/src/main/java/org/b3log/solo/util/Randoms.java

@@ -13,14 +13,13 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-/*
- * To change this template, choose Tools | Templates
- * and open the template in the editor.
- */
+
 package org.b3log.solo.util;
 
+
 import java.util.Random;
 
+
 /**
  * Generate random stuff, <p> currently only support random alpha and digital
  * string, whose length is also random between 8 and 16.
@@ -34,27 +33,32 @@ public class Randoms {
      * String's length should be positive.
      */
     private static final int LEN_LIM = 1;
+
     /**
      * String's length maximum limit.
      */
     private static final int MAX_LEN = 16;
+
     /**
      * String's length minimum limit.
      */
     private static final int MIN_LEN = 8;
+
     /**
      * String's random length.
      */
-    private static final int RANDOM_LEN = new Random()
-            .nextInt(MAX_LEN - MIN_LEN + LEN_LIM) + MIN_LEN;
+    private static final int RANDOM_LEN = new Random().nextInt(MAX_LEN - MIN_LEN + LEN_LIM) + MIN_LEN;
+
     /**
      * Characters set table, can be extended.
      */
     private final char[] table;
+
     /**
      * String's random seed.
      */
     private final Random random = new Random();
+
     /**
      * String's random characters buffer.
      */
@@ -76,8 +80,7 @@ public class Randoms {
         if (length < LEN_LIM) {
             throw new IllegalArgumentException("length < 1: " + length);
         }
-        table = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"
-                .toCharArray();
+        table = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ".toCharArray();
         buf = new char[length];
     }