+
+
+小而美的博客系统，专为程序员设计
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ * Loads skin from repository, loads skins from skin directory then sets it into preference if the skins changed. + *
+ */ + private void loadPreference() { + Stopwatchs.start("Load Preference"); + + LOGGER.debug("Loading preference...."); + + final OptionQueryService optionQueryService = beanManager.getReference(OptionQueryService.class); + JSONObject skin; + try { + skin = optionQueryService.getSkin(); + if (null == skin) { + return; + } + + final SkinMgmtService skinMgmtService = beanManager.getReference(SkinMgmtService.class); + skinMgmtService.loadSkins(skin); + } catch (final Exception e) { + LOGGER.log(Level.ERROR, e.getMessage(), e); + + System.exit(-1); + } + + Stopwatchs.end(); + } + + /** + * Register event handlers. + */ + private void registerEventHandlers() { + Stopwatchs.start("Register Event Handlers"); + LOGGER.debug("Registering event handlers...."); + + try { + final EventManager eventManager = beanManager.getReference(EventManager.class); + final PluginRefresher pluginRefresher = beanManager.getReference(PluginRefresher.class); + eventManager.registerListener(pluginRefresher); + eventManager.registerListener(new ViewLoadEventHandler()); + final B3ArticleSender articleSender = beanManager.getReference(B3ArticleSender.class); + eventManager.registerListener(articleSender); + final B3ArticleUpdater articleUpdater = beanManager.getReference(B3ArticleUpdater.class); + eventManager.registerListener(articleUpdater); + final B3CommentSender commentSender = beanManager.getReference(B3CommentSender.class); + eventManager.registerListener(commentSender); + } catch (final Exception e) { + LOGGER.log(Level.ERROR, "Register event handlers failed", e); + + System.exit(-1); + } + + LOGGER.debug("Registered event handlers"); + Stopwatchs.end(); + } + + /** + * Resolve skin (template) for the specified HTTP servlet request. + * 前台皮肤切换 https://github.com/b3log/solo/issues/12060 + * + * @param httpServletRequest the specified HTTP servlet request + */ + private void resolveSkinDir(final HttpServletRequest httpServletRequest) { + String skin = Skins.getSkinDirNameFromCookie(httpServletRequest); + if (StringUtils.isBlank(skin)) { + final OptionQueryService optionQueryService = beanManager.getReference(OptionQueryService.class); + final JSONObject skinOpt = optionQueryService.getSkin(); + if (Solos.isMobile(httpServletRequest)) { + if (null != skinOpt) { + skin = skinOpt.optString(Option.ID_C_MOBILE_SKIN_DIR_NAME); + } else { + skin = Option.DefaultPreference.DEFAULT_MOBILE_SKIN_DIR_NAME; + } + } else { + if (null != skinOpt) { + skin = skinOpt.optString(Option.ID_C_SKIN_DIR_NAME); + } else { + skin = Option.DefaultPreference.DEFAULT_SKIN_DIR_NAME; + } + } + } + + httpServletRequest.setAttribute(Keys.TEMAPLTE_DIR_NAME, skin); + } + + private static void fillBotAttrs(final HttpServletRequest request) { + final String userAgentStr = request.getHeader("User-Agent"); + final UserAgent userAgent = UserAgent.parseUserAgentString(userAgentStr); + BrowserType browserType = userAgent.getBrowser().getBrowserType(); + + if (StringUtils.containsIgnoreCase(userAgentStr, "mobile") + || StringUtils.containsIgnoreCase(userAgentStr, "MQQBrowser") + || StringUtils.containsIgnoreCase(userAgentStr, "iphone") + || StringUtils.containsIgnoreCase(userAgentStr, "MicroMessenger") + || StringUtils.containsIgnoreCase(userAgentStr, "CFNetwork") + || StringUtils.containsIgnoreCase(userAgentStr, "Android")) { + browserType = BrowserType.MOBILE_BROWSER; + } else if (StringUtils.containsIgnoreCase(userAgentStr, "Iframely") + || StringUtils.containsIgnoreCase(userAgentStr, "Google") + || StringUtils.containsIgnoreCase(userAgentStr, "BUbiNG") + || StringUtils.containsIgnoreCase(userAgentStr, "ltx71") + || StringUtils.containsIgnoreCase(userAgentStr, "py")) { + browserType = BrowserType.ROBOT; + } + + request.setAttribute(Keys.HttpRequest.IS_SEARCH_ENGINE_BOT, BrowserType.ROBOT == browserType); + request.setAttribute(Keys.HttpRequest.IS_MOBILE_BOT, BrowserType.MOBILE_BROWSER == browserType); + } + + /** + * Validates the default skin. + * + *+ * 改进皮肤加载校验 https://github.com/b3log/solo/issues/12548 + *
+ */ + private static void validateSkin() { + final String skinDirName = Option.DefaultPreference.DEFAULT_SKIN_DIR_NAME; + final String skinName = Latkes.getSkinName(skinDirName); + if (StringUtils.isBlank(skinName)) { + LOGGER.log(Level.ERROR, "Can't load the default skins, please make sure skin [" + skinDirName + "] is under skins directory and structure correctly"); + + System.exit(-1); + } + } + + /** + * 后台控制器使用函数式路由. https://github.com/b3log/solo/issues/12580 + */ + public static void routeConsoleProcessors() { + final BeanManager beanManager = BeanManager.getInstance(); + final AdminConsole adminConsole = beanManager.getReference(AdminConsole.class); + DispatcherServlet.get("/admin-index.do", adminConsole::showAdminIndex); + DispatcherServlet.get("/admin-preference.do", adminConsole::showAdminPreferenceFunction); + DispatcherServlet.route().get(new String[]{"/admin-article.do", + "/admin-article-list.do", + "/admin-comment-list.do", + "/admin-link-list.do", + "/admin-page-list.do", + "/admin-others.do", + "/admin-draft-list.do", + "/admin-user-list.do", + "/admin-category-list.do", + "/admin-theme-list.do", + "/admin-plugin-list.do", + "/admin-main.do", + "/admin-about.do"}, adminConsole::showAdminFunctions); + DispatcherServlet.get("/console/export/sql", adminConsole::exportSQL); + DispatcherServlet.get("/console/export/json", adminConsole::exportJSON); + DispatcherServlet.get("/console/export/hexo", adminConsole::exportHexo); + + final ArticleConsole articleConsole = beanManager.getReference(ArticleConsole.class); + DispatcherServlet.get("/console/article/push2rhy", articleConsole::pushArticleToCommunity); + DispatcherServlet.get("/console/thumbs", articleConsole::getArticleThumbs); + DispatcherServlet.get("/console/article/{id}", articleConsole::getArticle); + DispatcherServlet.get("/console/articles/status/{status}/{page}/{pageSize}/{windowSize}", articleConsole::getArticles); + DispatcherServlet.delete("/console/article/{id}", articleConsole::removeArticle); + DispatcherServlet.put("/console/article/unpublish/{id}", articleConsole::cancelPublishArticle); + DispatcherServlet.put("/console/article/canceltop/{id}", articleConsole::cancelTopArticle); + DispatcherServlet.put("/console/article/puttop/{id}", articleConsole::putTopArticle); + DispatcherServlet.put("/console/article/", articleConsole::updateArticle); + DispatcherServlet.post("/console/article/", articleConsole::addArticle); + + final CategoryConsole categoryConsole = beanManager.getReference(CategoryConsole.class); + DispatcherServlet.put("/console/category/order/", categoryConsole::changeOrder); + DispatcherServlet.get("/console/category/{id}", categoryConsole::getCategory); + DispatcherServlet.delete("/console/category/{id}", categoryConsole::removeCategory); + DispatcherServlet.put("/console/category/", categoryConsole::updateCategory); + DispatcherServlet.post("/console/category/", categoryConsole::addCategory); + DispatcherServlet.get("/console/categories/{page}/{pageSize}/{windowSize}", categoryConsole::getCategories); + + final CommentConsole commentConsole = beanManager.getReference(CommentConsole.class); + DispatcherServlet.delete("/console/article/comment/{id}", commentConsole::removeArticleComment); + DispatcherServlet.get("/console/comments/{page}/{pageSize}/{windowSize}", commentConsole::getComments); + DispatcherServlet.get("/console/comments/article/{id}", commentConsole::getArticleComments); + + final LinkConsole linkConsole = beanManager.getReference(LinkConsole.class); + DispatcherServlet.delete("/console/link/{id}", linkConsole::removeLink); + DispatcherServlet.put("/console/link/", linkConsole::updateLink); + DispatcherServlet.put("/console/link/order/", linkConsole::changeOrder); + DispatcherServlet.post("/console/link/", linkConsole::addLink); + DispatcherServlet.get("/console/links/{page}/{pageSize}/{windowSize}", linkConsole::getLinks); + DispatcherServlet.get("/console/link/{id}", linkConsole::getLink); + + final PageConsole pageConsole = beanManager.getReference(PageConsole.class); + DispatcherServlet.put("/console/page/", pageConsole::updatePage); + DispatcherServlet.delete("/console/page/{id}", pageConsole::removePage); + DispatcherServlet.post("/console/page/", pageConsole::addPage); + DispatcherServlet.put("/console/page/order/", pageConsole::changeOrder); + DispatcherServlet.get("/console/page/{id}", pageConsole::getPage); + DispatcherServlet.get("/console/pages/{page}/{pageSize}/{windowSize}", pageConsole::getPages); + + final PluginConsole pluginConsole = beanManager.getReference(PluginConsole.class); + DispatcherServlet.put("/console/plugin/status/", pluginConsole::setPluginStatus); + DispatcherServlet.get("/console/plugins/{page}/{pageSize}/{windowSize}", pluginConsole::getPlugins); + DispatcherServlet.post("/console/plugin/toSetting", pluginConsole::toSetting); + DispatcherServlet.post("/console/plugin/updateSetting", pluginConsole::updateSetting); + + final PreferenceConsole preferenceConsole = beanManager.getReference(PreferenceConsole.class); + DispatcherServlet.get("/console/signs/", preferenceConsole::getSigns); + DispatcherServlet.get("/console/preference/", preferenceConsole::getPreference); + DispatcherServlet.put("/console/preference/", preferenceConsole::updatePreference); + + final SkinConsole skinConsole = beanManager.getReference(SkinConsole.class); + DispatcherServlet.get("/console/skin", skinConsole::getSkin); + DispatcherServlet.put("/console/skin", skinConsole::updateSkin); + + final RepairConsole repairConsole = beanManager.getReference(RepairConsole.class); + DispatcherServlet.get("/fix/restore-signs", repairConsole::restoreSigns); + + final TagConsole tagConsole = beanManager.getReference(TagConsole.class); + DispatcherServlet.get("/console/tags", tagConsole::getTags); + DispatcherServlet.get("/console/tag/unused", tagConsole::getUnusedTags); + + final OtherConsole otherConsole = beanManager.getReference(OtherConsole.class); + DispatcherServlet.delete("/console/archive/unused", otherConsole::removeUnusedArchives); + DispatcherServlet.delete("/console/tag/unused", otherConsole::removeUnusedTags); + + final UserConsole userConsole = beanManager.getReference(UserConsole.class); + DispatcherServlet.put("/console/user/", userConsole::updateUser); + DispatcherServlet.delete("/console/user/{id}", userConsole::removeUser); + DispatcherServlet.get("/console/users/{page}/{pageSize}/{windowSize}", userConsole::getUsers); + DispatcherServlet.get("/console/user/{id}", userConsole::getUser); + DispatcherServlet.get("/console/changeRole/{id}", userConsole::changeUserRole); + + DispatcherServlet.mapping(); + } +} diff --git a/src/main/java/org/b3log/solo/Starter.java b/src/main/java/org/b3log/solo/Starter.java new file mode 100644 index 00000000..5ca005aa --- /dev/null +++ b/src/main/java/org/b3log/solo/Starter.java @@ -0,0 +1,202 @@ +/* + * Solo - A small and beautiful blogging system written in Java. + * Copyright (c) 2010-present, b3log.org + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU Affero General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Affero General Public License for more details. + * + * You should have received a copy of the GNU Affero General Public License + * along with this program. If not, see-
+ *
- Windows: java -cp "WEB-INF/lib/*;WEB-INF/classes" org.b3log.solo.Starter + *
- Unix-like: java -cp "WEB-INF/lib/*:WEB-INF/classes" org.b3log.solo.Starter + *
+ * API spec: https://hacpai.com/article/1457158841475 + *
+ * + * @author Liang Ding + * @author ArmstrongCN + * @version 1.0.2.20, Apr 13, 2019 + * @since 0.3.1 + */ +@Singleton +public class B3ArticleSender extends AbstractEventListener+ * API spec: https://hacpai.com/article/1457158841475 + *
+ * + * @author Liang Ding + * @version 1.0.1.6, Feb 8, 2019 + * @since 0.6.0 + */ +@Singleton +public class B3ArticleUpdater extends AbstractEventListener+ * Optional values: + *
-
+ *
- "titleOnly" + *
- "titleAndContent" + *
- "titleAndAbstract" + *
+ * Optional values: + *
-
+ *
- "abstract" + *
- "fullContent" + *
Open Sight, Open Future!\n\n"; + + /** + * Default meta keywords.. + */ + public static final String DEFAULT_META_KEYWORDS = "Solo,Java,博客,开源"; + + /** + * Default meta description.. + */ + public static final String DEFAULT_META_DESCRIPTION = "A small and beautiful blogging system. 一款小而美的博客系统。"; + + /** + * Default HTML head to append. + */ + public static final String DEFAULT_HTML_HEAD = ""; + + /** + * Default footer content. + */ + public static final String DEFAULT_FOOTER_CONTENT = ""; + + /** + * Default relevant articles display count. + */ + public static final int DEFAULT_RELEVANT_ARTICLES_DISPLAY_COUNT = 5; + + /** + * Default random articles display count. + */ + public static final int DEFAULT_RANDOM_ARTICLES_DISPLAY_COUNT = 5; + + /** + * Default external relevant articles display count. + */ + public static final int DEFAULT_EXTERNAL_RELEVANT_ARTICLES_DISPLAY_COUNT = 0; + + /** + * Most view articles display count. + */ + public static final int DEFAULT_MOST_VIEW_ARTICLES_DISPLAY_COUNT = 5; + + /** + * Default signs. + */ + public static final String DEFAULT_SIGNS; + + /** + * Default allow visit draft via permalink. + */ + public static final String DEFAULT_ALLOW_VISIT_DRAFT_VIA_PERMALINK = "false"; + + /** + * Default allow comment article/page. + */ + public static final String DEFAULT_COMMENTABLE = "true"; + + /** + * Default article list display style. + */ + public static final String DEFAULT_ARTICLE_LIST_STYLE = "titleAndAbstract"; + + /** + * Default feed output mode. + */ + public static final String DEFAULT_FEED_OUTPUT_MODE = "abstract"; + + /** + * Default feed output entry count. + */ + public static final int DEFAULT_FEED_OUTPUT_CNT = 10; + + static { + final JSONArray signs = new JSONArray(); + for (int i = 0; i < 4; i++) { + final JSONObject sign = new JSONObject(); + sign.put(Keys.OBJECT_ID, i); + signs.put(sign); + String html = "
\n\n"; + html += "标题：{title}
\n"; + html += "作者：{author}
\n"; + html += "地址：{url}
\n\n"; + html += "\n
"; + sign.put(Sign.SIGN_HTML, html); + } + + // Sign(id=0) is the 'empty' sign, used for article user needn't a sign + DEFAULT_SIGNS = signs.toString(); + } + + /** + * Private constructor. + */ + private DefaultPreference() { + } + } +} diff --git a/src/main/java/org/b3log/solo/model/Page.java b/src/main/java/org/b3log/solo/model/Page.java new file mode 100644 index 00000000..6974e001 --- /dev/null +++ b/src/main/java/org/b3log/solo/model/Page.java @@ -0,0 +1,85 @@ +/* + * Solo - A small and beautiful blogging system written in Java. + * Copyright (c) 2010-present, b3log.org + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU Affero General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Affero General Public License for more details. + * + * You should have received a copy of the GNU Affero General Public License + * along with this program. If not, see
+ * Available values: + *
-
+ *
- _blank + * Opens the linked document in a new window or tab. + *
- _self + * Opens the linked document in the same frame as it was clicked (this is default). + *
- _parent + * Opens the linked document in the parent frame. + *
- _top + * Opens the linked document in the full body of the window. + *
- frame name + * Opens the linked document in a named frame. + *
-
+ *
- Trims every tag + *
- Deduplication + *
+ * A valid user name: + *
-
+ *
- length [1, 64] + *
- content {a-z, A-Z, 0-9, -} + *
- Not contains "admin"/"Admin" + *
+ * See RFC 4278 for more details. + *
+ * + * @author Liang Ding + * @version 1.1.1.1, Aug 2, 2018 + * @see Entry + * @see Category + * @since 0.3.1 + */ +public final class Feed { + + /** + * Time zone id. + */ + public static final String TIME_ZONE_ID = "Asia/Shanghai"; + + /** + * Logger. + */ + private static final Logger LOGGER = Logger.getLogger(FeedProcessor.class); + + /** + * Link variable. + */ + private static final String LINK_VARIABLE = "${link}"; + + /** + * Start document. + */ + private static final String START_DOCUMENT = ""; + + /** + * Start feed element. + */ + private static final String START_FEED_ELEMENT = "+ * See RSS 2.0 at Harvard Law for more details. + *
+ * + * @author Liang Ding + * @version 1.1.1.2, Aug 2, 2018 + * @see Item + * @see Category + * @since 0.3.1 + */ +public final class Channel { + + /** + * Start. + */ + private static final String START = "+ * See Sitemap XML format + * for more details. + *
+ * + * @author Liang Ding + * @version 1.1.0.0, Sep 22, 2011 + * @see URL + * @since 0.3.1 + */ +public final class Sitemap { + + /** + * Start document. + */ + private static final String START_DOCUMENT = ""; + + /** + * Start URL set element. + */ + private static final String START_URL_SET_ELEMENT = "+ * Renders the response with a json object, for example, + *
+ * {
+ * "html": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ @RequestProcessing(value = "/console/markdown/2html", method = HttpMethod.POST)
+ public void markdown2HTML(final RequestContext context) {
+ final JSONObject result = Solos.newSucc();
+ context.renderJSON(result);
+
+ final String markdownText = context.requestJSON().optString("markdownText");
+ if (StringUtils.isBlank(markdownText)) {
+ result.put(Common.DATA, "");
+
+ return;
+ }
+
+ if (!Solos.isLoggedIn(context)) {
+ result.put(Keys.CODE, -1);
+ result.put(Keys.MSG, langPropsService.get("getFailLabel"));
+
+ return;
+ }
+
+ try {
+ final String html = Markdowns.toHTML(markdownText);
+ result.put(Common.DATA, html);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+ result.put(Keys.CODE, -1);
+ result.put(Keys.MSG, langPropsService.get("getFailLabel"));
+ }
+ }
+
+ /**
+ * Shows the article view password form.
+ *
+ * @param context the specified context
+ */
+ @RequestProcessing(value = "/console/article-pwd", method = HttpMethod.GET)
+ public void showArticlePwdForm(final RequestContext context) {
+ final String articleId = context.param("articleId");
+ if (StringUtils.isBlank(articleId)) {
+ context.sendError(HttpServletResponse.SC_NOT_FOUND);
+
+ return;
+ }
+
+ final JSONObject article = articleQueryService.getArticleById(articleId);
+ if (null == article) {
+ context.sendError(HttpServletResponse.SC_NOT_FOUND);
+
+ return;
+ }
+
+ final AbstractFreeMarkerRenderer renderer = new ConsoleRenderer(context, "article-pwd.ftl");
+ final Map+ * Request json: + *
+ * {
+ * "article": {
+ * "id": "",
+ * "title": "",
+ * "content": "",
+ * "contentHTML": "",
+ * "tags": "tag1,tag2,tag3"
+ * },
+ * "client": {
+ * "userName": "",
+ * "userB3Key": ""
+ * }
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "oId": "", // Generated article id
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ @RequestProcessing(value = "/apis/symphony/article", method = {HttpMethod.POST, HttpMethod.PUT})
+ public void postArticle(final RequestContext context) {
+ final JSONObject ret = new JSONObject().put(Keys.CODE, 0);
+ context.renderJSON(ret);
+
+ final JSONObject requestJSONObject = context.requestJSON();
+ LOGGER.log(Level.INFO, "Adds an article from Sym [" + requestJSONObject.toString() + "]");
+
+ try {
+ final JSONObject client = requestJSONObject.optJSONObject("client");
+ final String articleAuthorName = client.optString(User.USER_NAME);
+ final JSONObject articleAuthor = userRepository.getByUserName(articleAuthorName);
+ if (null == articleAuthor) {
+ ret.put(Keys.CODE, 1);
+ final String msg = "Not found user [" + articleAuthorName + "]";
+ ret.put(Keys.MSG, msg);
+ LOGGER.log(Level.WARN, msg);
+
+ return;
+ }
+
+ final String b3Key = client.optString(UserExt.USER_B3_KEY);
+ final String key = articleAuthor.optString(UserExt.USER_B3_KEY);
+ if (!StringUtils.equals(key, b3Key)) {
+ ret.put(Keys.CODE, 1);
+ final String msg = "Wrong key";
+ ret.put(Keys.MSG, msg);
+ LOGGER.log(Level.WARN, msg);
+
+ return;
+ }
+
+ final JSONObject symArticle = requestJSONObject.optJSONObject(Article.ARTICLE);
+ final String title = symArticle.optString("title");
+ final String articleId = symArticle.optString("id");
+ final JSONObject oldArticle = articleQueryService.getArticleById(articleId);
+ if (null == oldArticle) {
+ final JSONObject article = new JSONObject().
+ put(Keys.OBJECT_ID, symArticle.optString("id")).
+ put(Article.ARTICLE_TITLE, title).
+ put(Article.ARTICLE_CONTENT, symArticle.optString("content")).
+ put(Article.ARTICLE_TAGS_REF, symArticle.optString("tags"));
+ article.put(Article.ARTICLE_AUTHOR_ID, articleAuthor.getString(Keys.OBJECT_ID));
+ final String articleContent = article.optString(Article.ARTICLE_CONTENT);
+ article.put(Article.ARTICLE_ABSTRACT, Article.getAbstractText(articleContent));
+ article.put(Article.ARTICLE_STATUS, Article.ARTICLE_STATUS_C_PUBLISHED);
+ article.put(Common.POST_TO_COMMUNITY, false); // Do not send to rhythm
+ article.put(Article.ARTICLE_COMMENTABLE, true);
+ article.put(Article.ARTICLE_VIEW_PWD, "");
+ final String content = article.getString(Article.ARTICLE_CONTENT);
+ article.put(Article.ARTICLE_CONTENT, content);
+ final JSONObject addRequest = new JSONObject().put(Article.ARTICLE, article);
+ articleMgmtService.addArticle(addRequest);
+ LOGGER.log(Level.INFO, "Added an article [" + title + "] via Sym");
+
+ return;
+ }
+
+ final String articleContent = symArticle.optString("content");
+ oldArticle.put(Article.ARTICLE_ABSTRACT, Article.getAbstractText(articleContent));
+ oldArticle.put(Article.ARTICLE_CONTENT, articleContent);
+ oldArticle.put(Article.ARTICLE_TITLE, symArticle.optString("title"));
+ oldArticle.put(Article.ARTICLE_TAGS_REF, symArticle.optString("tags"));
+ oldArticle.put(Common.POST_TO_COMMUNITY, false); // Do not send to rhythm
+ final JSONObject updateRequest = new JSONObject().put(Article.ARTICLE, oldArticle);
+ articleMgmtService.updateArticle(updateRequest);
+ LOGGER.log(Level.INFO, "Updated an article [" + title + "] via Sym");
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+ ret.put(Keys.CODE, 1).put(Keys.MSG, e.getMessage());
+ }
+ }
+
+ /**
+ * Adds a comment with the specified request.
+ * + * Request json: + *
+ * {
+ * "comment": {
+ * "articleId": "",
+ * "content": "",
+ * "contentHTML": "",
+ * "ua": "",
+ * "ip": "",
+ * "authorName": "",
+ * "authorURL": "",
+ * "authorAvatarURL": "",
+ * "isArticleAuthor": true,
+ * "time": 1457784330398
+ * },
+ * "client": {
+ * "userName": "88250",
+ * "userB3Key": ""
+ * }
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": true
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ @RequestProcessing(value = "/apis/symphony/comment", method = HttpMethod.PUT)
+ public void addComment(final RequestContext context) {
+ final JSONObject ret = new JSONObject().put(Keys.CODE, 0);
+ context.renderJSON(ret);
+
+ final JSONObject requestJSONObject = context.requestJSON();
+
+ LOGGER.log(Level.INFO, "Adds a comment from Sym [" + requestJSONObject.toString() + "]");
+
+ try {
+ final JSONObject symCmt = requestJSONObject.optJSONObject(Comment.COMMENT);
+ final JSONObject symClient = requestJSONObject.optJSONObject("client");
+ final String articleAuthorName = symClient.optString(User.USER_NAME);
+ final JSONObject articleAuthor = userRepository.getByUserName(articleAuthorName);
+ if (null == articleAuthor) {
+ ret.put(Keys.CODE, 1);
+ final String msg = "Not found user [" + articleAuthorName + "]";
+ ret.put(Keys.MSG, msg);
+ LOGGER.log(Level.WARN, msg);
+
+ return;
+ }
+
+ final String b3Key = symClient.optString(UserExt.USER_B3_KEY);
+ final String key = articleAuthor.optString(UserExt.USER_B3_KEY);
+ if (!StringUtils.equals(key, b3Key)) {
+ ret.put(Keys.CODE, 1);
+ final String msg = "Wrong key";
+ ret.put(Keys.MSG, msg);
+ LOGGER.log(Level.WARN, msg);
+
+ return;
+ }
+
+ final String articleId = symCmt.getString("articleId");
+ final JSONObject article = articleRepository.get(articleId);
+ if (null == article) {
+ ret.put(Keys.CODE, 1);
+ final String msg = "Not found the specified article [id=" + articleId + "]";
+ ret.put(Keys.MSG, msg);
+ LOGGER.log(Level.WARN, msg);
+
+ return;
+ }
+
+ final String commentName = symCmt.getString("authorName");
+ String commentURL = symCmt.optString("authorURL");
+ if (!Strings.isURL(commentURL)) {
+ commentURL = "";
+ }
+ final String commentThumbnailURL = symCmt.getString("authorAvatarURL");
+
+ final JSONObject commenter = userRepository.getByUserName(commentName);
+ if (null == commenter) {
+ // 社区回帖同步博客评论 https://github.com/b3log/solo/issues/12691
+ final JSONObject addUserReq = new JSONObject();
+ addUserReq.put(User.USER_NAME, commentName);
+ addUserReq.put(UserExt.USER_AVATAR, commentThumbnailURL);
+ addUserReq.put(User.USER_ROLE, Role.VISITOR_ROLE);
+ addUserReq.put(UserExt.USER_GITHUB_ID, "");
+ addUserReq.put(UserExt.USER_B3_KEY, "");
+ try {
+ userMgmtService.addUser(addUserReq);
+ LOGGER.log(Level.INFO, "Created a user [role=" + Role.VISITOR_ROLE + "] via Sym comment");
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, "Adds a user [" + commentName + "] failed", e);
+ ret.put(Keys.CODE, 1);
+ ret.put(Keys.MSG, "Adds a user [" + commentName + "] failed");
+
+ return;
+ }
+ }
+
+ if (!optionQueryService.allowComment() || !article.optBoolean(Article.ARTICLE_COMMENTABLE)) {
+ ret.put(Keys.CODE, 1);
+ final String msg = "Not allow comment";
+ ret.put(Keys.MSG, msg);
+ LOGGER.log(Level.WARN, msg);
+
+ return;
+ }
+
+ String commentContent = symCmt.getString("content"); // Markdown
+
+ final Transaction transaction = commentRepository.beginTransaction();
+ final JSONObject comment = new JSONObject();
+ final String commentId = Ids.genTimeMillisId();
+ comment.put(Keys.OBJECT_ID, commentId);
+ comment.put(Comment.COMMENT_NAME, commentName);
+ comment.put(Comment.COMMENT_URL, commentURL);
+ comment.put(Comment.COMMENT_THUMBNAIL_URL, commentThumbnailURL);
+ comment.put(Comment.COMMENT_CONTENT, commentContent);
+ final Date date = new Date();
+ comment.put(Comment.COMMENT_CREATED, date.getTime());
+ comment.put(Comment.COMMENT_ORIGINAL_COMMENT_ID, "");
+ comment.put(Comment.COMMENT_ORIGINAL_COMMENT_NAME, "");
+ comment.put(Comment.COMMENT_ON_ID, articleId);
+ final String commentSharpURL = Comment.getCommentSharpURLForArticle(article, commentId);
+ comment.put(Comment.COMMENT_SHARP_URL, commentSharpURL);
+ commentRepository.add(comment);
+ articleMgmtService.incArticleCommentCount(articleId);
+ transaction.commit();
+
+ LOGGER.log(Level.INFO, "Added a comment from Sym [" + requestJSONObject.toString() + "]");
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+ ret.put(Keys.CODE, 1).put(Keys.MSG, e.getMessage());
+ }
+ }
+}
diff --git a/src/main/java/org/b3log/solo/processor/BlogProcessor.java b/src/main/java/org/b3log/solo/processor/BlogProcessor.java
new file mode 100644
index 00000000..cbeaa66c
--- /dev/null
+++ b/src/main/java/org/b3log/solo/processor/BlogProcessor.java
@@ -0,0 +1,185 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see -
+ *
- Time of the recent updated article + *
- Article count + *
- Comment count + *
- Tag count + *
- Serve path + *
- Static serve path + *
- Solo version + *
- Runtime mode + *
- Runtime database + *
- Locale + *
- Admin username + *
+ *
+ * {
+ * "data": [
+ * ["tag1", "tag2", ....], // tags of one article
+ * ["tagX", "tagY", ....], // tags of another article
+ * ....
+ * ]
+ * }
+ *
+ *
+ *
+ * @param context the specified context
+ */
+ @RequestProcessing(value = "/blog/articles-tags", method = HttpMethod.GET)
+ public void getArticlesTags(final RequestContext context) {
+ final JSONObject requestJSONObject = new JSONObject();
+ requestJSONObject.put(Pagination.PAGINATION_CURRENT_PAGE_NUM, 1);
+ requestJSONObject.put(Pagination.PAGINATION_PAGE_SIZE, Integer.MAX_VALUE);
+ requestJSONObject.put(Pagination.PAGINATION_WINDOW_SIZE, Integer.MAX_VALUE);
+ requestJSONObject.put(Article.ARTICLE_STATUS, Article.ARTICLE_STATUS_C_PUBLISHED);
+
+ final JSONArray excludes = new JSONArray();
+
+ excludes.put(Article.ARTICLE_CONTENT);
+ excludes.put(Article.ARTICLE_UPDATED);
+ excludes.put(Article.ARTICLE_CREATED);
+ excludes.put(Article.ARTICLE_AUTHOR_ID);
+ excludes.put(Article.ARTICLE_RANDOM_DOUBLE);
+
+ requestJSONObject.put(Keys.EXCLUDES, excludes);
+
+ final JSONObject result = articleQueryService.getArticles(requestJSONObject);
+ final JSONArray articles = result.optJSONArray(Article.ARTICLES);
+
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+ renderer.setJSONObject(ret);
+
+ final JSONArray data = new JSONArray();
+ ret.put("data", data);
+
+ for (int i = 0; i < articles.length(); i++) {
+ final JSONObject article = articles.optJSONObject(i);
+ final String tagString = article.optString(Article.ARTICLE_TAGS_REF);
+
+ final JSONArray tagArray = new JSONArray();
+ data.put(tagArray);
+
+ final String[] tags = tagString.split(",");
+
+ for (final String tag : tags) {
+ final String trim = tag.trim();
+ if (StringUtils.isNotBlank(trim)) {
+ tagArray.put(tag);
+ }
+ }
+ }
+ }
+}
diff --git a/src/main/java/org/b3log/solo/processor/CategoryProcessor.java b/src/main/java/org/b3log/solo/processor/CategoryProcessor.java
new file mode 100644
index 00000000..2a59409e
--- /dev/null
+++ b/src/main/java/org/b3log/solo/processor/CategoryProcessor.java
@@ -0,0 +1,244 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see + * Request json: + *
+ * {
+ * "captcha": "",
+ * "oId": articleId,
+ * "commentName": "",
+ * "commentURL": "",
+ * "commentContent": "",
+ * "commentOriginalCommentId": "" // optional, if exists this key, the comment is an reply
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "oId": generatedCommentId,
+ * "sc": "COMMENT_ARTICLE_SUCC",
+ * "commentDate": "", // yyyy/MM/dd HH:mm:ss
+ * "commentSharpURL": "",
+ * "commentThumbnailURL": "",
+ * "commentOriginalCommentName": "", // if exists this key, the comment is an reply
+ * "commentContent": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified context, including a request json object
+ */
+ @RequestProcessing(value = "/article/comments", method = HttpMethod.POST)
+ public void addArticleComment(final RequestContext context) {
+ final JSONObject requestJSONObject = context.requestJSON();
+ requestJSONObject.put(Common.TYPE, Article.ARTICLE);
+
+ String anonymousName = "不愿透露姓名的靓仔";
+ String commentName = "";
+ try {
+ commentName = requestJSONObject.getString("commentName");
+ } catch (JSONException JSONE) {
+ requestJSONObject.put("commentName", anonymousName);
+ commentName = anonymousName;
+ }
+
+ fillCommenter(requestJSONObject, context);
+
+ final JSONObject jsonObject = commentMgmtService.checkAddCommentRequest(requestJSONObject);
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ renderer.setJSONObject(jsonObject);
+
+ /*if (!jsonObject.optBoolean(Keys.STATUS_CODE)) {
+ LOGGER.log(Level.WARN, "Can't add comment[msg={0}]", jsonObject.optString(Keys.MSG));
+ return;
+ }*/
+
+ //防止冒用用户名
+ if (!commentName.equals(anonymousName)) {
+ if (!Solos.isLoggedIn(context)) {
+ jsonObject.put(Keys.STATUS_CODE, false);
+ jsonObject.put(Keys.MSG, "Need login");
+
+ return;
+ }
+ }
+
+ try {
+ final JSONObject addResult = commentMgmtService.addArticleComment(requestJSONObject);
+
+ final Map-
+ *
- Redirects to auth page (/oauth/github/redirect), GET + *
- OAuth callback (/oauth/github), GET + *
+ * User can add a template (for example "links.ftl") then visits the page ("links.html"). + *
+ * + * @author Liang Ding + * @version 1.0.0.10, Jan 5, 2019 + * @since 0.4.5 + */ +@RequestProcessor +public class UserTemplateProcessor { + + /** + * Logger. + */ + private static final Logger LOGGER = Logger.getLogger(ArticleProcessor.class); + + /** + * DataModelService. + */ + @Inject + private DataModelService dataModelService; + + /** + * Language service. + */ + @Inject + private LangPropsService langPropsService; + + /** + * Statistic management service. + */ + @Inject + private StatisticMgmtService statisticMgmtService; + + /** + * Option query service. + */ + @Inject + private OptionQueryService optionQueryService; + + /** + * Shows the user template page. + * + * @param context the specified context + */ + @RequestProcessing(value = "/{name}.html", method = HttpMethod.GET) + public void showPage(final RequestContext context) { + final String requestURI = context.requestURI(); + final String templateName = context.pathVar("name") + ".ftl"; + LOGGER.log(Level.DEBUG, "Shows page [requestURI={0}, templateName={1}]", requestURI, templateName); + + final HttpServletRequest request = context.getRequest(); + final HttpServletResponse response = context.getResponse(); + final AbstractFreeMarkerRenderer renderer = new SkinRenderer(context, templateName); + + final Map+ * Renders the response with a json object, for example, + *
+ * {
+ * "sc": true,
+ * "data": [
+ * "https://img.hacpai.com/bing/20171226.jpg?imageView2/1/w/960/h/540/interlace/1/q/100",
+ * "https://img.hacpai.com/bing/20171105.jpg?imageView2/1/w/960/h/540/interlace/1/q/100",
+ * "https://img.hacpai.com/bing/20180105.jpg?imageView2/1/w/960/h/540/interlace/1/q/100",
+ * "https://img.hacpai.com/bing/20171114.jpg?imageView2/1/w/960/h/540/interlace/1/q/100"
+ * ]
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void getArticleThumbs(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject result = new JSONObject();
+ renderer.setJSONObject(result);
+ result.put(Keys.STATUS_CODE, true);
+ final HttpServletRequest request = context.getRequest();
+ String strN = context.param("n");
+ if (!Strings.isNumeric(strN)) {
+ strN = "6";
+ }
+
+ final int n = Integer.valueOf(strN);
+ final List+ * Renders the response with a json object, for example, + *
+ * {
+ * "oId": "",
+ * "articleTitle": "",
+ * "articleAbstract": "",
+ * "articleContent": "",
+ * "articlePermalink": "",
+ * "articleTags": [{
+ * "oId": "",
+ * "tagTitle": ""
+ * }, ....],
+ * "articleSignId": "",
+ * "signs": [{
+ * "oId": "",
+ * "signHTML": ""
+ * }, ....]
+ * "sc": "GET_ARTICLE_SUCC"
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void getArticle(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ try {
+ final String articleId = context.pathVar("id");
+ final JSONObject result = articleQueryService.getArticle(articleId);
+ result.put(Keys.STATUS_CODE, true);
+ renderer.setJSONObject(result);
+ } catch (final ServiceException e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("getFailLabel"));
+ }
+ }
+
+ /**
+ * Gets articles(by crate date descending) by the specified request json object.
+ * + * The request URI contains the pagination arguments. For example, the request URI is + * /console/articles/status/published/1/10/20, means the current page is 1, the page size is 10, and the window size + * is 20. + *
+ *+ * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "pagination": {
+ * "paginationPageCount": 100,
+ * "paginationPageNums": [1, 2, 3, 4, 5]
+ * },
+ * "articles": [{
+ * "oId": "",
+ * "articleTitle": "",
+ * "articleCommentCount": int,
+ * "articleCreateTime"; long,
+ * "articleViewCount": int,
+ * "articleTags": "tag1, tag2, ....",
+ * "articlePutTop": boolean,
+ * "articleStatus": int
+ * }, ....]
+ * }
+ * , order by article update date and sticky(put top).
+ *
+ *
+ * @param context the specified request context
+ */
+ public void getArticles(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ try {
+ String path = context.requestURI().substring((Latkes.getContextPath() + "/console/articles/status/").length());
+ final String status = StringUtils.substringBefore(path, "/");
+
+ path = path.substring((status + "/").length());
+ final JSONObject requestJSONObject = Solos.buildPaginationRequest(path);
+ requestJSONObject.put(Article.ARTICLE_STATUS, "published".equals(status) ? Article.ARTICLE_STATUS_C_PUBLISHED : Article.ARTICLE_STATUS_C_DRAFT);
+
+ final JSONArray excludes = new JSONArray();
+ excludes.put(Article.ARTICLE_CONTENT);
+ excludes.put(Article.ARTICLE_UPDATED);
+ excludes.put(Article.ARTICLE_CREATED);
+ excludes.put(Article.ARTICLE_AUTHOR_ID);
+ excludes.put(Article.ARTICLE_RANDOM_DOUBLE);
+ requestJSONObject.put(Keys.EXCLUDES, excludes);
+
+ final String keyword = StringUtils.trim(context.param("k"));
+ if (StringUtils.isNotBlank(keyword)) {
+ requestJSONObject.put(Common.KEYWORD, keyword);
+ }
+
+ final JSONObject result = articleQueryService.getArticles(requestJSONObject);
+ result.put(Keys.STATUS_CODE, true);
+ renderer.setJSONObject(result);
+
+ final JSONArray articles = result.optJSONArray(Article.ARTICLES);
+ for (int i = 0; i < articles.length(); i++) {
+ final JSONObject article = articles.optJSONObject(i);
+ String title = article.optString(Article.ARTICLE_TITLE);
+ title = StringEscapeUtils.escapeXml(title);
+ article.put(Article.ARTICLE_TITLE, title);
+ }
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("getFailLabel"));
+ }
+ }
+
+ /**
+ * Removes an article by the specified request.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void removeArticle(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+ renderer.setJSONObject(ret);
+ final String articleId = context.pathVar("id");
+ final JSONObject currentUser = Solos.getCurrentUser(context.getRequest(), context.getResponse());
+
+ try {
+ if (!articleQueryService.canAccessArticle(articleId, currentUser)) {
+ ret.put(Keys.STATUS_CODE, false);
+ ret.put(Keys.MSG, langPropsService.get("forbiddenLabel"));
+
+ return;
+ }
+
+ articleMgmtService.removeArticle(articleId);
+
+ ret.put(Keys.STATUS_CODE, true);
+ ret.put(Keys.MSG, langPropsService.get("removeSuccLabel"));
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject();
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.STATUS_CODE, false);
+ jsonObject.put(Keys.MSG, langPropsService.get("removeFailLabel"));
+ }
+ }
+
+ /**
+ * Cancels publish an article by the specified request.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void cancelPublishArticle(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+ renderer.setJSONObject(ret);
+
+ try {
+ final String articleId = context.pathVar("id");
+ final JSONObject currentUser = Solos.getCurrentUser(context.getRequest(), context.getResponse());
+ if (!articleQueryService.canAccessArticle(articleId, currentUser)) {
+ ret.put(Keys.STATUS_CODE, false);
+ ret.put(Keys.MSG, langPropsService.get("forbiddenLabel"));
+
+ return;
+ }
+
+ articleMgmtService.cancelPublishArticle(articleId);
+
+ ret.put(Keys.STATUS_CODE, true);
+ ret.put(Keys.MSG, langPropsService.get("unPulbishSuccLabel"));
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject();
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.STATUS_CODE, false);
+ jsonObject.put(Keys.MSG, langPropsService.get("unPulbishFailLabel"));
+ }
+ }
+
+ /**
+ * Cancels an top article by the specified request.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void cancelTopArticle(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+ renderer.setJSONObject(ret);
+ if (!Solos.isAdminLoggedIn(context)) {
+ ret.put(Keys.MSG, langPropsService.get("forbiddenLabel"));
+ ret.put(Keys.STATUS_CODE, false);
+
+ return;
+ }
+
+ try {
+ final String articleId = context.pathVar("id");
+ articleMgmtService.topArticle(articleId, false);
+ ret.put(Keys.STATUS_CODE, true);
+ ret.put(Keys.MSG, langPropsService.get("cancelTopSuccLabel"));
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject();
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.STATUS_CODE, false);
+ jsonObject.put(Keys.MSG, langPropsService.get("cancelTopFailLabel"));
+ }
+ }
+
+ /**
+ * Puts an article to top by the specified request.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void putTopArticle(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+ renderer.setJSONObject(ret);
+ if (!Solos.isAdminLoggedIn(context)) {
+ ret.put(Keys.MSG, langPropsService.get("forbiddenLabel"));
+ ret.put(Keys.STATUS_CODE, false);
+
+ return;
+ }
+
+ try {
+ final String articleId = context.pathVar("id");
+ articleMgmtService.topArticle(articleId, true);
+ ret.put(Keys.STATUS_CODE, true);
+ ret.put(Keys.MSG, langPropsService.get("putTopSuccLabel"));
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject();
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.STATUS_CODE, false);
+ jsonObject.put(Keys.MSG, langPropsService.get("putTopFailLabel"));
+ }
+ }
+
+ /**
+ * Updates an article by the specified request json object.
+ * + * The specified request json object, for example, + *
+ * {
+ * "article": {
+ * "oId": "",
+ * "articleTitle": "",
+ * "articleAbstract": "",
+ * "articleContent": "",
+ * "articleTags": "tag1,tag2,tag3", // optional, default set "待分类"
+ * "articlePermalink": "", // optional
+ * "articleStatus": int, // 0: published, 1: draft
+ * "articleSignId": "" // optional
+ * "articleCommentable": boolean,
+ * "articleViewPwd": "",
+ * "postToCommunity": boolean
+ * }
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void updateArticle(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+ try {
+ final JSONObject requestJSONObject = context.requestJSON();
+ final JSONObject article = requestJSONObject.getJSONObject(Article.ARTICLE);
+ final String articleId = article.getString(Keys.OBJECT_ID);
+ renderer.setJSONObject(ret);
+
+ final JSONObject currentUser = Solos.getCurrentUser(context.getRequest(), context.getResponse());
+ if (!articleQueryService.canAccessArticle(articleId, currentUser)) {
+ ret.put(Keys.MSG, langPropsService.get("forbiddenLabel"));
+ ret.put(Keys.STATUS_CODE, false);
+
+ return;
+ }
+
+ // 打印请求日志，如果发生特殊情况丢失数据，至少还可以根据日志寻回内容
+ LOGGER.log(Level.INFO, "Updates an article request [" + requestJSONObject.toString() + "]");
+
+ articleMgmtService.updateArticle(requestJSONObject);
+
+ ret.put(Keys.MSG, langPropsService.get("updateSuccLabel"));
+ ret.put(Keys.STATUS_CODE, true);
+ } catch (final ServiceException e) {
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, e.getMessage());
+ }
+ }
+
+ /**
+ * Adds an article with the specified request.
+ * + * The specified request json object, for example, + *
+ * {
+ * "article": {
+ * "articleTitle": "",
+ * "articleAbstract": "",
+ * "articleContent": "",
+ * "articleTags": "tag1,tag2,tag3", // optional, default set "待分类"
+ * "articlePermalink": "", // optional
+ * "articleStatus": int, // 0: published, 1: draft
+ * "postToCommunity": boolean,
+ * "articleSignId": "" // optional
+ * "articleCommentable": boolean,
+ * "articleViewPwd": ""
+ * }
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "oId": "", // Generated article id
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void addArticle(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+ try {
+ final JSONObject requestJSONObject = context.requestJSON();
+ final JSONObject currentUser = Solos.getCurrentUser(context.getRequest(), context.getResponse());
+ requestJSONObject.getJSONObject(Article.ARTICLE).put(Article.ARTICLE_AUTHOR_ID, currentUser.getString(Keys.OBJECT_ID));
+
+ // 打印请求日志，如果发生特殊情况丢失数据，至少还可以根据日志寻回内容
+ LOGGER.log(Level.INFO, "Adds an article request [" + requestJSONObject.toString() + "]");
+
+ final String articleId = articleMgmtService.addArticle(requestJSONObject);
+ ret.put(Keys.OBJECT_ID, articleId);
+ ret.put(Keys.MSG, langPropsService.get("addSuccLabel"));
+ ret.put(Keys.STATUS_CODE, true);
+
+ renderer.setJSONObject(ret);
+ } catch (final ServiceException e) {
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, e.getMessage());
+ }
+ }
+}
diff --git a/src/main/java/org/b3log/solo/processor/console/CategoryConsole.java b/src/main/java/org/b3log/solo/processor/console/CategoryConsole.java
new file mode 100644
index 00000000..fd82e8ea
--- /dev/null
+++ b/src/main/java/org/b3log/solo/processor/console/CategoryConsole.java
@@ -0,0 +1,543 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see + * Request json: + *
+ * {
+ * "oId": "",
+ * "direction": "" // "up"/"down"
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ * @throws Exception exception
+ */
+ public void changeOrder(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+ try {
+ final JSONObject requestJSON = context.requestJSON();
+ final String categoryId = requestJSON.getString(Keys.OBJECT_ID);
+ final String direction = requestJSON.getString(Common.DIRECTION);
+
+ categoryMgmtService.changeOrder(categoryId, direction);
+
+ ret.put(Keys.STATUS_CODE, true);
+ ret.put(Keys.MSG, langPropsService.get("updateSuccLabel"));
+ renderer.setJSONObject(ret);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("updateFailLabel"));
+ }
+ }
+
+ /**
+ * Gets a category by the specified request.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "category": {
+ * "oId": "",
+ * "categoryTitle": "",
+ * "categoryURI": "",
+ * ....
+ * }
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ * @throws Exception exception
+ */
+ @SuppressWarnings("unchecked")
+ public void getCategory(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ try {
+ final String categoryId = context.pathVar("id");
+ final JSONObject result = categoryQueryService.getCategory(categoryId);
+ if (null == result) {
+ renderer.setJSONObject(new JSONObject().put(Keys.STATUS_CODE, false));
+
+ return;
+ }
+
+ final StringBuilder tagBuilder = new StringBuilder();
+ final List+ * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ * @throws Exception exception
+ */
+ public void removeCategory(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject jsonObject = new JSONObject();
+ renderer.setJSONObject(jsonObject);
+ try {
+ final String categoryId = context.pathVar("id");
+ categoryMgmtService.removeCategory(categoryId);
+
+ jsonObject.put(Keys.STATUS_CODE, true);
+ jsonObject.put(Keys.MSG, langPropsService.get("removeSuccLabel"));
+ } catch (final ServiceException e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ jsonObject.put(Keys.STATUS_CODE, false);
+ jsonObject.put(Keys.MSG, langPropsService.get("removeFailLabel"));
+ }
+ }
+
+ /**
+ * Updates a category by the specified request.
+ * + * Request json: + *
+ * {
+ * "oId": "",
+ * "categoryTitle": "",
+ * "categoryURI": "", // optional
+ * "categoryDescription": "", // optional
+ * "categoryTags": "tag1, tag2" // optional
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void updateCategory(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+ renderer.setJSONObject(ret);
+
+ try {
+ final JSONObject requestJSON = context.requestJSON();
+ String tagsStr = requestJSON.optString(Category.CATEGORY_T_TAGS);
+ tagsStr = Tag.formatTags(tagsStr, 64);
+ if (StringUtils.isBlank(tagsStr)) {
+ throw new ServiceException(langPropsService.get("tagsEmptyLabel"));
+ }
+ final String[] tagTitles = tagsStr.split(",");
+ String addArticleWithTagFirstLabel = langPropsService.get("addArticleWithTagFirstLabel");
+
+ final List+ * Request json: + *
+ * {
+ * "categoryTitle": "",
+ * "categoryURI": "", // optional
+ * "categoryDescription": "", // optional
+ * "categoryTags": "tag1, tag2" // optional
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "oId": "", // Generated category id
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void addCategory(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+ renderer.setJSONObject(ret);
+
+ try {
+ final JSONObject requestJSONObject = context.requestJSON();
+ String tagsStr = requestJSONObject.optString(Category.CATEGORY_T_TAGS);
+ tagsStr = Tag.formatTags(tagsStr, 64);
+ if (StringUtils.isBlank(tagsStr)) {
+ throw new ServiceException(langPropsService.get("tagsEmptyLabel"));
+ }
+ final String[] tagTitles = tagsStr.split(",");
+ String addArticleWithTagFirstLabel = langPropsService.get("addArticleWithTagFirstLabel");
+
+ final List+ * The request URI contains the pagination arguments. For example, the request URI is /console/categories/1/10/20, means + * the current page is 1, the page size is 10, and the window size is 20. + *
+ *+ * Renders the response with a json object, for example, + *
+ * {
+ * "pagination": {
+ * "paginationPageCount": 100,
+ * "paginationPageNums": [1, 2, 3, 4, 5]
+ * },
+ * "categories": [{
+ * "oId": "",
+ * "categoryTitle": "",
+ * "categoryURI": "",
+ * ....
+ * }, ....]
+ * "sc": true
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void getCategories(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+
+ try {
+ final HttpServletRequest request = context.getRequest();
+ final String requestURI = context.requestURI();
+ final String path = requestURI.substring((Latkes.getContextPath() + "/console/categories/").length());
+ final JSONObject requestJSONObject = Solos.buildPaginationRequest(path);
+ final JSONObject result = categoryQueryService.getCategoris(requestJSONObject);
+ result.put(Keys.STATUS_CODE, true);
+ renderer.setJSONObject(result);
+
+ final JSONArray categories = result.optJSONArray(Category.CATEGORIES);
+ for (int i = 0; i < categories.length(); i++) {
+ final JSONObject category = categories.optJSONObject(i);
+ String title = category.optString(Category.CATEGORY_TITLE);
+ title = StringEscapeUtils.escapeXml(title);
+ category.put(Category.CATEGORY_TITLE, title);
+ }
+ } catch (final ServiceException e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("getFailLabel"));
+ }
+ }
+}
diff --git a/src/main/java/org/b3log/solo/processor/console/CommentConsole.java b/src/main/java/org/b3log/solo/processor/console/CommentConsole.java
new file mode 100644
index 00000000..f1912c97
--- /dev/null
+++ b/src/main/java/org/b3log/solo/processor/console/CommentConsole.java
@@ -0,0 +1,212 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void removeArticleComment(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+ renderer.setJSONObject(ret);
+
+ try {
+ final String commentId = context.pathVar("id");
+ final JSONObject currentUser = Solos.getCurrentUser(context.getRequest(), context.getResponse());
+ if (!commentQueryService.canAccessComment(commentId, currentUser)) {
+ ret.put(Keys.STATUS_CODE, false);
+ ret.put(Keys.MSG, langPropsService.get("forbiddenLabel"));
+
+ return;
+ }
+
+ commentMgmtService.removeArticleComment(commentId);
+
+ ret.put(Keys.STATUS_CODE, true);
+ ret.put(Keys.MSG, langPropsService.get("removeSuccLabel"));
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ ret.put(Keys.STATUS_CODE, false);
+ ret.put(Keys.MSG, langPropsService.get("removeFailLabel"));
+ }
+ }
+
+ /**
+ * Gets comments by the specified request.
+ * + * The request URI contains the pagination arguments. For example, the + * request URI is /console/comments/1/10/20, means the current page is 1, the + * page size is 10, and the window size is 20. + *
+ *+ * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "pagination": {
+ * "paginationPageCount": 100,
+ * "paginationPageNums": [1, 2, 3, 4, 5]
+ * },
+ * "comments": [{
+ * "oId": "",
+ * "commentTitle": "",
+ * "commentName": "",
+ * "thumbnailUrl": "",
+ * "commentURL": "",
+ * "commentContent": "",
+ * "commentTime": long,
+ * "commentSharpURL": ""
+ * }, ....]
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void getComments(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+
+ try {
+ final String requestURI = context.requestURI();
+ final String path = requestURI.substring((Latkes.getContextPath() + "/console/comments/").length());
+
+ final JSONObject requestJSONObject = Solos.buildPaginationRequest(path);
+ final JSONObject result = commentQueryService.getComments(requestJSONObject);
+
+ result.put(Keys.STATUS_CODE, true);
+
+ renderer.setJSONObject(result);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("getFailLabel"));
+ }
+ }
+
+ /**
+ * Gets comments of an article specified by the article id for administrator.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "comments": [{
+ * "oId": "",
+ * "commentName": "",
+ * "thumbnailUrl": "",
+ * "commentURL": "",
+ * "commentContent": "",
+ * "commentTime": long,
+ * "commentSharpURL": "",
+ * "isReply": boolean
+ * }, ....]
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void getArticleComments(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+ renderer.setJSONObject(ret);
+
+ try {
+ final String articleId = context.pathVar("id");
+ final List+ * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void removeLink(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject jsonObject = new JSONObject();
+ renderer.setJSONObject(jsonObject);
+
+ try {
+ final String linkId = context.pathVar("id");
+ linkMgmtService.removeLink(linkId);
+
+ jsonObject.put(Keys.STATUS_CODE, true);
+ jsonObject.put(Keys.MSG, langPropsService.get("removeSuccLabel"));
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ jsonObject.put(Keys.STATUS_CODE, false);
+ jsonObject.put(Keys.MSG, langPropsService.get("removeFailLabel"));
+ }
+ }
+
+ /**
+ * Updates a link by the specified request.
+ * + * Request json: + *
+ * {
+ * "link": {
+ * "oId": "",
+ * "linkTitle": "",
+ * "linkAddress": "",
+ * "linkDescription": ""
+ * }
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void updateLink(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+
+ try {
+ final JSONObject requestJSON = context.requestJSON();
+ linkMgmtService.updateLink(requestJSON);
+
+ ret.put(Keys.STATUS_CODE, true);
+ ret.put(Keys.MSG, langPropsService.get("updateSuccLabel"));
+ renderer.setJSONObject(ret);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("updateFailLabel"));
+ }
+ }
+
+ /**
+ * Changes a link order by the specified link id and direction.
+ * + * Request json: + *
+ * {
+ * "oId": "",
+ * "direction": "" // "up"/"down"
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void changeOrder(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+
+ try {
+ final JSONObject requestJSON = context.requestJSON();
+ final String linkId = requestJSON.getString(Keys.OBJECT_ID);
+ final String direction = requestJSON.getString(Common.DIRECTION);
+
+ linkMgmtService.changeOrder(linkId, direction);
+
+ ret.put(Keys.STATUS_CODE, true);
+ ret.put(Keys.MSG, langPropsService.get("updateSuccLabel"));
+ renderer.setJSONObject(ret);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("updateFailLabel"));
+ }
+ }
+
+ /**
+ * Adds a link with the specified request.
+ * + *
+ * {
+ * "link": {
+ * "linkTitle": "",
+ * "linkAddress": "",
+ * "linkDescription": ""
+ * }
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "oId": "", // Generated link id
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void addLink(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+
+ try {
+ final JSONObject requestJSON = context.requestJSON();
+ final String linkId = linkMgmtService.addLink(requestJSON);
+
+ ret.put(Keys.OBJECT_ID, linkId);
+ ret.put(Keys.MSG, langPropsService.get("addSuccLabel"));
+ ret.put(Keys.STATUS_CODE, true);
+ renderer.setJSONObject(ret);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("addFailLabel"));
+ }
+ }
+
+ /**
+ * Gets links by the specified request.
+ * + * The request URI contains the pagination arguments. For example, the + * request URI is /console/links/1/10/20, means the current page is 1, the + * page size is 10, and the window size is 20. + *
+ *+ * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "pagination": {
+ * "paginationPageCount": 100,
+ * "paginationPageNums": [1, 2, 3, 4, 5]
+ * },
+ * "links": [{
+ * "oId": "",
+ * "linkTitle": "",
+ * "linkAddress": "",
+ * "linkDescription": ""
+ * }, ....]
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void getLinks(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+
+ try {
+ final String requestURI = context.requestURI();
+ final String path = requestURI.substring((Latkes.getContextPath() + "/console/links/").length());
+ final JSONObject requestJSONObject = Solos.buildPaginationRequest(path);
+ final JSONObject result = linkQueryService.getLinks(requestJSONObject);
+ result.put(Keys.STATUS_CODE, true);
+ renderer.setJSONObject(result);
+
+ final JSONArray links = result.optJSONArray(Link.LINKS);
+ for (int i = 0; i < links.length(); i++) {
+ final JSONObject link = links.optJSONObject(i);
+ String title = link.optString(Link.LINK_TITLE);
+ title = StringEscapeUtils.escapeXml(title);
+ link.put(Link.LINK_TITLE, title);
+ }
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("getFailLabel"));
+ }
+ }
+
+ /**
+ * Gets the file with the specified request.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "link": {
+ * "oId": "",
+ * "linkTitle": "",
+ * "linkAddress": "",
+ * "linkDescription": ""
+ * }
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void getLink(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+
+ try {
+ final String linkId = context.pathVar("id");
+ final JSONObject result = linkQueryService.getLink(linkId);
+ if (null == result) {
+ renderer.setJSONObject(new JSONObject().put(Keys.STATUS_CODE, false));
+
+ return;
+ }
+
+ renderer.setJSONObject(result);
+ result.put(Keys.STATUS_CODE, true);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("getFailLabel"));
+ }
+ }
+}
diff --git a/src/main/java/org/b3log/solo/processor/console/OtherConsole.java b/src/main/java/org/b3log/solo/processor/console/OtherConsole.java
new file mode 100644
index 00000000..ab4a9ea4
--- /dev/null
+++ b/src/main/java/org/b3log/solo/processor/console/OtherConsole.java
@@ -0,0 +1,129 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see + * Renders the response with a json object, for example, + *
+ * {
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ @Before(ConsoleAdminAuthAdvice.class)
+ public void removeUnusedArchives(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject jsonObject = new JSONObject();
+ renderer.setJSONObject(jsonObject);
+
+ try {
+ archiveDateMgmtService.removeUnusedArchiveDates();
+
+ jsonObject.put(Keys.STATUS_CODE, true);
+ jsonObject.put(Keys.MSG, langPropsService.get("removeSuccLabel"));
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, "Removes unused archives failed", e);
+
+ jsonObject.put(Keys.MSG, langPropsService.get("removeFailLabel"));
+ }
+ }
+
+ /**
+ * Removes all unused tags.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ @Before(ConsoleAdminAuthAdvice.class)
+ public void removeUnusedTags(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject jsonObject = new JSONObject();
+ renderer.setJSONObject(jsonObject);
+
+ try {
+ tagMgmtService.removeUnusedTags();
+
+ jsonObject.put(Keys.STATUS_CODE, true);
+ jsonObject.put(Keys.MSG, langPropsService.get("removeSuccLabel"));
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, "Removes unused tags failed", e);
+
+ jsonObject.put(Keys.MSG, langPropsService.get("removeFailLabel"));
+ }
+ }
+}
diff --git a/src/main/java/org/b3log/solo/processor/console/PageConsole.java b/src/main/java/org/b3log/solo/processor/console/PageConsole.java
new file mode 100644
index 00000000..33984f3b
--- /dev/null
+++ b/src/main/java/org/b3log/solo/processor/console/PageConsole.java
@@ -0,0 +1,361 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see + * Request json: + *
+ * {
+ * "page": {
+ * "oId": "",
+ * "pageTitle": "",
+ * "pageOrder": int,
+ * "pagePermalink": "",
+ * "pageOpenTarget": "",
+ * "pageIcon": ""
+ * }
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void updatePage(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+
+ try {
+ final JSONObject requestJSON = context.requestJSON();
+ pageMgmtService.updatePage(requestJSON);
+
+ ret.put(Keys.STATUS_CODE, true);
+ ret.put(Keys.MSG, langPropsService.get("updateSuccLabel"));
+ renderer.setJSONObject(ret);
+ } catch (final ServiceException e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("updateFailLabel"));
+ }
+ }
+
+ /**
+ * Removes a page by the specified request.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void removePage(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject jsonObject = new JSONObject();
+ renderer.setJSONObject(jsonObject);
+
+ try {
+ final String pageId = context.pathVar("id");
+ pageMgmtService.removePage(pageId);
+
+ jsonObject.put(Keys.STATUS_CODE, true);
+ jsonObject.put(Keys.MSG, langPropsService.get("removeSuccLabel"));
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ jsonObject.put(Keys.STATUS_CODE, false);
+ jsonObject.put(Keys.MSG, langPropsService.get("removeFailLabel"));
+
+ }
+ }
+
+ /**
+ * Adds a page with the specified request.
+ * + * Request json: + *
+ * {
+ * "page": {
+ * "pageTitle": "",
+ * "pagePermalink": "" // optional
+ * "pageOpenTarget": "",
+ * "pageIcon": ""
+ * }
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "oId": "", // Generated page id
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void addPage(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+
+ try {
+ final JSONObject requestJSON = context.requestJSON();
+ final String pageId = pageMgmtService.addPage(requestJSON);
+
+ ret.put(Keys.OBJECT_ID, pageId);
+ ret.put(Keys.MSG, langPropsService.get("addSuccLabel"));
+ ret.put(Keys.STATUS_CODE, true);
+ renderer.setJSONObject(ret);
+ } catch (final ServiceException e) { // May be permalink check exception
+ LOGGER.log(Level.WARN, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("updateFailLabel"));
+ }
+ }
+
+ /**
+ * Changes a page order by the specified page id and direction.
+ * + * Request json: + *
+ * {
+ * "oId": "",
+ * "direction": "" // "up"/"down"
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void changeOrder(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+
+ try {
+ final JSONObject requestJSONObject = context.requestJSON();
+ final String linkId = requestJSONObject.getString(Keys.OBJECT_ID);
+ final String direction = requestJSONObject.getString(Common.DIRECTION);
+
+ pageMgmtService.changeOrder(linkId, direction);
+
+ ret.put(Keys.STATUS_CODE, true);
+ ret.put(Keys.MSG, langPropsService.get("updateSuccLabel"));
+
+ renderer.setJSONObject(ret);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("updateFailLabel"));
+ }
+ }
+
+ /**
+ * Gets a page by the specified request.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean
+ * "page": {
+ * "oId": "",
+ * "pageTitle": "",
+ * "pageOrder": int,
+ * "pagePermalink": "",
+ * "pageIcon": ""
+ * }
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void getPage(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+
+ try {
+ final String pageId = context.pathVar("id");
+ final JSONObject result = pageQueryService.getPage(pageId);
+ if (null == result) {
+ renderer.setJSONObject(new JSONObject().put(Keys.STATUS_CODE, false));
+
+ return;
+ }
+
+ renderer.setJSONObject(result);
+ result.put(Keys.STATUS_CODE, true);
+ result.put(Keys.MSG, langPropsService.get("getSuccLabel"));
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("getFailLabel"));
+ }
+ }
+
+ /**
+ * Gets pages by the specified request.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "pagination": {
+ * "paginationPageCount": 100,
+ * "paginationPageNums": [1, 2, 3, 4, 5]
+ * },
+ * "pages": [{
+ * "oId": "",
+ * "pageTitle": "",
+ * "pageOrder": int,
+ * "pagePermalink": "",
+ * .{@link PageMgmtService...}
+ * }, ....]
+ * "sc": "GET_PAGES_SUCC"
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void getPages(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+
+ try {
+ final String requestURI = context.requestURI();
+ final String path = requestURI.substring((Latkes.getContextPath() + "/console/pages/").length());
+ final JSONObject requestJSONObject = Solos.buildPaginationRequest(path);
+ final JSONObject result = pageQueryService.getPages(requestJSONObject);
+ final JSONArray pages = result.optJSONArray(Page.PAGES);
+
+ for (int i = 0; i < pages.length(); i++) {
+ final JSONObject page = pages.getJSONObject(i);
+ String title = page.optString(Page.PAGE_TITLE);
+ title = StringEscapeUtils.escapeXml(title);
+ page.put(Page.PAGE_TITLE, title);
+ }
+
+ result.put(Keys.STATUS_CODE, true);
+ renderer.setJSONObject(result);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("getFailLabel"));
+ }
+ }
+}
diff --git a/src/main/java/org/b3log/solo/processor/console/PluginConsole.java b/src/main/java/org/b3log/solo/processor/console/PluginConsole.java
new file mode 100644
index 00000000..891e1aba
--- /dev/null
+++ b/src/main/java/org/b3log/solo/processor/console/PluginConsole.java
@@ -0,0 +1,191 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void setPluginStatus(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+
+ final JSONObject requestJSONObject = context.requestJSON();
+ final String pluginId = requestJSONObject.getString(Keys.OBJECT_ID);
+ final String status = requestJSONObject.getString(Plugin.PLUGIN_STATUS);
+ final JSONObject result = pluginMgmtService.setPluginStatus(pluginId, status);
+
+ renderer.setJSONObject(result);
+ }
+
+ /**
+ * Gets plugins by the specified request.
+ * + * The request URI contains the pagination arguments. For example, the + * request URI is /console/plugins/1/10/20, means the current page is 1, the + * page size is 10, and the window size is 20. + *
+ *+ * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "pagination": {
+ * "paginationPageCount": 100,
+ * "paginationPageNums": [1, 2, 3, 4, 5]
+ * },
+ * "plugins": [{
+ * "name": "",
+ * "version": "",
+ * "author": "",
+ * "status": "", // Enumeration name of {@link org.b3log.latke.plugin.PluginStatus}
+ * }, ....]
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ * @throws Exception exception
+ */
+ public void getPlugins(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+
+ try {
+ final String requestURI = context.requestURI();
+ final String path = requestURI.substring((Latkes.getContextPath() + "/console/plugins/").length());
+ final JSONObject requestJSONObject = Solos.buildPaginationRequest(path);
+ final JSONObject result = pluginQueryService.getPlugins(requestJSONObject);
+
+ renderer.setJSONObject(result);
+ result.put(Keys.STATUS_CODE, true);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("getFailLabel"));
+ }
+ }
+
+ /**
+ * get the info of the specified pluginoId,just fot the plugin-setting.
+ *
+ * @param context the specified request context
+ */
+ public void toSetting(final RequestContext context) {
+ final ConsoleRenderer renderer = new ConsoleRenderer(context, "admin-plugin-setting.ftl");
+ final Map+ * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "signs": [{
+ * "oId": "",
+ * "signHTML": ""
+ * }, ...]
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void getSigns(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+
+ try {
+ final JSONObject preference = optionQueryService.getPreference();
+ final JSONArray signs = new JSONArray();
+ final JSONArray allSigns = // includes the empty sign(id=0)
+ new JSONArray(preference.getString(Option.ID_C_SIGNS));
+
+ for (int i = 1; i < allSigns.length(); i++) { // excludes the empty sign
+ signs.put(allSigns.getJSONObject(i));
+ }
+
+ final JSONObject ret = new JSONObject();
+ renderer.setJSONObject(ret);
+ ret.put(Sign.SIGNS, signs);
+ ret.put(Keys.STATUS_CODE, true);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("getFailLabel"));
+ }
+ }
+
+ /**
+ * Gets preference.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "preference": {
+ * "mostViewArticleDisplayCount": int,
+ * "recentCommentDisplayCount": int,
+ * "mostUsedTagDisplayCount": int,
+ * "articleListDisplayCount": int,
+ * "articleListPaginationWindowSize": int,
+ * "mostCommentArticleDisplayCount": int,
+ * "externalRelevantArticlesDisplayCount": int,
+ * "relevantArticlesDisplayCount": int,
+ * "randomArticlesDisplayCount": int,
+ * "blogTitle": "",
+ * "blogSubtitle": "",
+ * "localeString": "",
+ * "timeZoneId": "",
+ * "skinDirName": "",
+ * "skins": "[{
+ * "skinDirName": ""
+ * }, ....]",
+ * "noticeBoard": "",
+ * "footerContent": "",
+ * "htmlHead": "",
+ * "metaKeywords": "",
+ * "metaDescription": "",
+ * "enableArticleUpdateHint": boolean,
+ * "signs": "[{
+ * "oId": "",
+ * "signHTML": ""
+ * }, ...]",
+ * "allowVisitDraftViaPermalink": boolean,
+ * "version": "",
+ * "articleListStyle": "", // Optional values: "titleOnly"/"titleAndContent"/"titleAndAbstract"
+ * "commentable": boolean,
+ * "feedOutputMode: "" // Optional values: "abstract"/"full"
+ * "feedOutputCnt": int,
+ * "faviconURL": "",
+ * "syncGitHub": boolean,
+ * "pullGitHub": boolean,
+ * "customVars" "", // 支持配置自定义参数 https://github.com/b3log/solo/issues/12535
+ * }
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void getPreference(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+
+ try {
+ final JSONObject preference = optionQueryService.getPreference();
+ if (null == preference) {
+ renderer.setJSONObject(new JSONObject().put(Keys.STATUS_CODE, false));
+
+ return;
+ }
+
+ String footerContent = "";
+ final JSONObject opt = optionQueryService.getOptionById(Option.ID_C_FOOTER_CONTENT);
+ if (null != opt) {
+ footerContent = opt.optString(Option.OPTION_VALUE);
+ }
+ preference.put(Option.ID_C_FOOTER_CONTENT, footerContent);
+
+ final JSONObject ret = new JSONObject();
+ renderer.setJSONObject(ret);
+ ret.put(Option.CATEGORY_C_PREFERENCE, preference);
+ ret.put(Keys.STATUS_CODE, true);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("getFailLabel"));
+ }
+ }
+
+ /**
+ * Updates the preference by the specified request.
+ * + * Request json: + *
+ * {
+ * "preference": {
+ * "mostViewArticleDisplayCount": int,
+ * "recentCommentDisplayCount": int,
+ * "mostUsedTagDisplayCount": int,
+ * "articleListDisplayCount": int,
+ * "articleListPaginationWindowSize": int,
+ * "mostCommentArticleDisplayCount": int,
+ * "externalRelevantArticlesDisplayCount": int,
+ * "relevantArticlesDisplayCount": int,
+ * "randomArticlesDisplayCount": int,
+ * "blogTitle": "",
+ * "blogSubtitle": "",
+ * "localeString": "",
+ * "timeZoneId": "",
+ * "noticeBoard": "",
+ * "footerContent": "",
+ * "htmlHead": "",
+ * "metaKeywords": "",
+ * "metaDescription": "",
+ * "enableArticleUpdateHint": boolean,
+ * "signs": [{
+ * "oId": "",
+ * "signHTML": ""
+ * }, ...],
+ * "allowVisitDraftViaPermalink": boolean,
+ * "articleListStyle": "",
+ * "commentable": boolean,
+ * "feedOutputMode: "",
+ * "feedOutputCnt": int,
+ * "faviconURL": "",
+ * "syncGitHub": boolean,
+ * "pullGitHub": boolean,
+ * "customVars" "", // 支持配置自定义参数 https://github.com/b3log/solo/issues/12535
+ * }
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void updatePreference(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+
+ try {
+ final JSONObject requestJSONObject = context.requestJSON();
+ final JSONObject preference = requestJSONObject.getJSONObject(Option.CATEGORY_C_PREFERENCE);
+ final JSONObject ret = new JSONObject();
+ renderer.setJSONObject(ret);
+ if (isInvalid(preference, ret)) {
+ return;
+ }
+
+ preferenceMgmtService.updatePreference(preference);
+
+ ret.put(Keys.STATUS_CODE, true);
+ ret.put(Keys.MSG, langPropsService.get("updateSuccLabel"));
+ } catch (final ServiceException e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("updateFailLabel"));
+ }
+ }
+
+ /**
+ * Checks whether the specified preference is invalid and sets the specified response object.
+ *
+ * @param preference the specified preference
+ * @param responseObject the specified response object
+ * @return {@code true} if the specified preference is invalid, returns {@code false} otherwise
+ */
+ private boolean isInvalid(final JSONObject preference, final JSONObject responseObject) {
+ responseObject.put(Keys.STATUS_CODE, false);
+
+ final StringBuilder errMsgBuilder = new StringBuilder('[' + langPropsService.get("paramSettingsLabel"));
+ errMsgBuilder.append(" - ");
+
+ String input = preference.optString(Option.ID_C_EXTERNAL_RELEVANT_ARTICLES_DISPLAY_CNT);
+ if (!isNonNegativeInteger(input)) {
+ errMsgBuilder.append(langPropsService.get("externalRelevantArticlesDisplayCntLabel")).append("] ")
+ .append(langPropsService.get("nonNegativeIntegerOnlyLabel"));
+ responseObject.put(Keys.MSG, errMsgBuilder.toString());
+ return true;
+ }
+
+ input = preference.optString(Option.ID_C_RELEVANT_ARTICLES_DISPLAY_CNT);
+ if (!isNonNegativeInteger(input)) {
+ errMsgBuilder.append(langPropsService.get("relevantArticlesDisplayCntLabel")).append("] ")
+ .append(langPropsService.get("nonNegativeIntegerOnlyLabel"));
+ responseObject.put(Keys.MSG, errMsgBuilder.toString());
+ return true;
+ }
+
+ input = preference.optString(Option.ID_C_RANDOM_ARTICLES_DISPLAY_CNT);
+ if (!isNonNegativeInteger(input)) {
+ errMsgBuilder.append(langPropsService.get("randomArticlesDisplayCntLabel")).append("] ")
+ .append(langPropsService.get("nonNegativeIntegerOnlyLabel"));
+ responseObject.put(Keys.MSG, errMsgBuilder.toString());
+ return true;
+ }
+
+ input = preference.optString(Option.ID_C_MOST_COMMENT_ARTICLE_DISPLAY_CNT);
+ if (!isNonNegativeInteger(input)) {
+ errMsgBuilder.append(langPropsService.get("indexMostCommentArticleDisplayCntLabel")).append("] ")
+ .append(langPropsService.get("nonNegativeIntegerOnlyLabel"));
+ responseObject.put(Keys.MSG, errMsgBuilder.toString());
+ return true;
+ }
+
+ input = preference.optString(Option.ID_C_MOST_VIEW_ARTICLE_DISPLAY_CNT);
+ if (!isNonNegativeInteger(input)) {
+ errMsgBuilder.append(langPropsService.get("indexMostViewArticleDisplayCntLabel")).append("] ")
+ .append(langPropsService.get("nonNegativeIntegerOnlyLabel"));
+ responseObject.put(Keys.MSG, errMsgBuilder.toString());
+ return true;
+ }
+
+ input = preference.optString(Option.ID_C_RECENT_COMMENT_DISPLAY_CNT);
+ if (!isNonNegativeInteger(input)) {
+ errMsgBuilder.append(langPropsService.get("indexRecentCommentDisplayCntLabel")).append("] ")
+ .append(langPropsService.get("nonNegativeIntegerOnlyLabel"));
+ responseObject.put(Keys.MSG, errMsgBuilder.toString());
+ return true;
+ }
+
+ input = preference.optString(Option.ID_C_MOST_USED_TAG_DISPLAY_CNT);
+ if (!isNonNegativeInteger(input)) {
+ errMsgBuilder.append(langPropsService.get("indexTagDisplayCntLabel")).append("] ")
+ .append(langPropsService.get("nonNegativeIntegerOnlyLabel"));
+ responseObject.put(Keys.MSG, errMsgBuilder.toString());
+ return true;
+ }
+
+ input = preference.optString(Option.ID_C_ARTICLE_LIST_DISPLAY_COUNT);
+ if (!isNonNegativeInteger(input)) {
+ errMsgBuilder.append(langPropsService.get("pageSizeLabel")).append("] ")
+ .append(langPropsService.get("nonNegativeIntegerOnlyLabel"));
+ responseObject.put(Keys.MSG, errMsgBuilder.toString());
+ return true;
+ }
+
+ input = preference.optString(Option.ID_C_ARTICLE_LIST_PAGINATION_WINDOW_SIZE);
+ if (!isNonNegativeInteger(input)) {
+ errMsgBuilder.append(langPropsService.get("windowSizeLabel")).append("] ")
+ .append(langPropsService.get("nonNegativeIntegerOnlyLabel"));
+ responseObject.put(Keys.MSG, errMsgBuilder.toString());
+ return true;
+ }
+
+ input = preference.optString(Option.ID_C_FEED_OUTPUT_CNT);
+ if (!isNonNegativeInteger(input)) {
+ errMsgBuilder.append(langPropsService.get("feedOutputCntLabel")).append("] ")
+ .append(langPropsService.get("nonNegativeIntegerOnlyLabel"));
+ responseObject.put(Keys.MSG, errMsgBuilder.toString());
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Checks whether the specified input is a non-negative integer.
+ *
+ * @param input the specified input
+ * @return {@code true} if it is, returns {@code false} otherwise
+ */
+ private boolean isNonNegativeInteger(final String input) {
+ try {
+ return 0 <= Integer.valueOf(input);
+ } catch (final Exception e) {
+ return false;
+ }
+ }
+}
diff --git a/src/main/java/org/b3log/solo/processor/console/RepairConsole.java b/src/main/java/org/b3log/solo/processor/console/RepairConsole.java
new file mode 100644
index 00000000..29cfdd5f
--- /dev/null
+++ b/src/main/java/org/b3log/solo/processor/console/RepairConsole.java
@@ -0,0 +1,116 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "skin": {
+ * "skinDirName": "",
+ * "mobileSkinDirName": "",
+ * "skins": "[{
+ * "skinDirName": ""
+ * }, ....]"
+ * }
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void getSkin(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+
+ try {
+ final JSONObject skin = optionQueryService.getSkin();
+ if (null == skin) {
+ renderer.setJSONObject(new JSONObject().put(Keys.STATUS_CODE, false));
+
+ return;
+ }
+
+ final Set+ * Request json: + *
+ * {
+ * "skin": {
+ * "skinDirName": "",
+ * "mobileSkinDirName": "",
+ * }
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ public void updateSkin(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+
+ try {
+ final JSONObject requestJSONObject = context.requestJSON();
+ final JSONObject skin = requestJSONObject.getJSONObject(Option.CATEGORY_C_SKIN);
+ final JSONObject ret = new JSONObject();
+ renderer.setJSONObject(ret);
+
+ skinMgmtService.updateSkin(skin);
+
+ final HttpServletResponse response = context.getResponse();
+ final Cookie skinDirNameCookie = new Cookie(Common.COOKIE_NAME_SKIN, skin.getString(Option.ID_C_SKIN_DIR_NAME));
+ skinDirNameCookie.setMaxAge(60 * 60); // 1 hour
+ skinDirNameCookie.setPath("/");
+ response.addCookie(skinDirNameCookie);
+ final Cookie mobileSkinDirNameCookie = new Cookie(Common.COOKIE_NAME_MOBILE_SKIN, skin.getString(Option.ID_C_MOBILE_SKIN_DIR_NAME));
+ mobileSkinDirNameCookie.setMaxAge(60 * 60); // 1 hour
+ mobileSkinDirNameCookie.setPath("/");
+ response.addCookie(mobileSkinDirNameCookie);
+
+ ret.put(Keys.STATUS_CODE, true);
+ ret.put(Keys.MSG, langPropsService.get("updateSuccLabel"));
+ } catch (final ServiceException e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("updateFailLabel"));
+ }
+ }
+
+ /**
+ * Checks whether the specified input is a non-negative integer.
+ *
+ * @param input the specified input
+ * @return {@code true} if it is, returns {@code false} otherwise
+ */
+ private boolean isNonNegativeInteger(final String input) {
+ try {
+ return 0 <= Integer.valueOf(input);
+ } catch (final Exception e) {
+ return false;
+ }
+ }
+}
diff --git a/src/main/java/org/b3log/solo/processor/console/TagConsole.java b/src/main/java/org/b3log/solo/processor/console/TagConsole.java
new file mode 100644
index 00000000..e7c2eafa
--- /dev/null
+++ b/src/main/java/org/b3log/solo/processor/console/TagConsole.java
@@ -0,0 +1,139 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "tags": [
+ * {"tagTitle": "", ....},
+ * ....
+ * ]
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ @Before(ConsoleAuthAdvice.class)
+ public void getTags(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject jsonObject = new JSONObject();
+ renderer.setJSONObject(jsonObject);
+
+ try {
+ jsonObject.put(Tag.TAGS, tagQueryService.getTags());
+ jsonObject.put(Keys.STATUS_CODE, true);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, "Gets tags failed", e);
+
+ jsonObject.put(Keys.STATUS_CODE, false);
+ }
+ }
+
+ /**
+ * Gets all unused tags.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "unusedTags": [
+ * {"tagTitle": "", ....},
+ * ....
+ * ]
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ @Before(ConsoleAdminAuthAdvice.class)
+ public void getUnusedTags(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject jsonObject = new JSONObject();
+ renderer.setJSONObject(jsonObject);
+
+ final List+ * Request json: + *
+ * {
+ * "oId": "",
+ * "userName": "",
+ * "userRole": "",
+ * "userURL": "",
+ * "userAvatar": "",
+ * "userB3Key": ""
+ * }
+ *
+ *
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ @Before(ConsoleAdminAuthAdvice.class)
+ public void updateUser(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject ret = new JSONObject();
+
+ try {
+ final JSONObject requestJSONObject = context.requestJSON();
+ userMgmtService.updateUser(requestJSONObject);
+
+ ret.put(Keys.STATUS_CODE, true);
+ ret.put(Keys.MSG, langPropsService.get("updateSuccLabel"));
+ renderer.setJSONObject(ret);
+ } catch (final ServiceException e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("updateFailLabel"));
+ }
+ }
+
+ /**
+ * Removes a user by the specified request.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ @Before(ConsoleAdminAuthAdvice.class)
+ public void removeUser(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject jsonObject = new JSONObject();
+ renderer.setJSONObject(jsonObject);
+ try {
+ final String userId = context.pathVar("id");
+ userMgmtService.removeUser(userId);
+
+ jsonObject.put(Keys.STATUS_CODE, true);
+ jsonObject.put(Keys.MSG, langPropsService.get("removeSuccLabel"));
+ } catch (final ServiceException e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ jsonObject.put(Keys.STATUS_CODE, false);
+ jsonObject.put(Keys.MSG, langPropsService.get("removeFailLabel"));
+ }
+ }
+
+ /**
+ * Gets users by the specified request json object.
+ * + * The request URI contains the pagination arguments. For example, the request URI is /console/users/1/10/20, means + * the current page is 1, the page size is 10, and the window size is 20. + *
+ *+ * Renders the response with a json object, for example, + *
+ * {
+ * "pagination": {
+ * "paginationPageCount": 100,
+ * "paginationPageNums": [1, 2, 3, 4, 5]
+ * },
+ * "users": [{
+ * "oId": "",
+ * "userName": "",
+ * "roleName": "",
+ * ....
+ * }, ....]
+ * "sc": true
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ @Before(ConsoleAdminAuthAdvice.class)
+ public void getUsers(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+
+ try {
+ final String requestURI = context.requestURI();
+ final String path = requestURI.substring((Latkes.getContextPath() + "/console/users/").length());
+ final JSONObject requestJSONObject = Solos.buildPaginationRequest(path);
+ final JSONObject result = userQueryService.getUsers(requestJSONObject);
+ result.put(Keys.STATUS_CODE, true);
+ renderer.setJSONObject(result);
+
+ final JSONArray users = result.optJSONArray(User.USERS);
+ for (int i = 0; i < users.length(); i++) {
+ final JSONObject user = users.optJSONObject(i);
+ String userName = user.optString(User.USER_NAME);
+ userName = StringEscapeUtils.escapeXml(userName);
+ user.put(User.USER_NAME, userName);
+ }
+ } catch (final ServiceException e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("getFailLabel"));
+ }
+ }
+
+ /**
+ * Gets a user by the specified request.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "user": {
+ * "oId": "",
+ * "userName": "",
+ * "userAvatar": ""
+ * }
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ @Before(ConsoleAdminAuthAdvice.class)
+ public void getUser(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final String userId = context.pathVar("id");
+
+ final JSONObject result = userQueryService.getUser(userId);
+ if (null == result) {
+ final JSONObject jsonObject = new JSONObject().put(Keys.STATUS_CODE, false);
+ renderer.setJSONObject(jsonObject);
+ jsonObject.put(Keys.MSG, langPropsService.get("getFailLabel"));
+
+ return;
+ }
+
+ renderer.setJSONObject(result);
+ result.put(Keys.STATUS_CODE, true);
+ }
+
+ /**
+ * Change a user role.
+ * + * Renders the response with a json object, for example, + *
+ * {
+ * "sc": boolean,
+ * "msg": ""
+ * }
+ *
+ *
+ *
+ * @param context the specified request context
+ */
+ @Before(ConsoleAdminAuthAdvice.class)
+ public void changeUserRole(final RequestContext context) {
+ final JsonRenderer renderer = new JsonRenderer();
+ context.setRenderer(renderer);
+ final JSONObject jsonObject = new JSONObject();
+ renderer.setJSONObject(jsonObject);
+ try {
+ final String userId = context.pathVar("id");
+ userMgmtService.changeRole(userId);
+
+ jsonObject.put(Keys.STATUS_CODE, true);
+ jsonObject.put(Keys.MSG, langPropsService.get("updateSuccLabel"));
+ } catch (final ServiceException e) {
+ LOGGER.log(Level.ERROR, e.getMessage(), e);
+
+ jsonObject.put(Keys.STATUS_CODE, false);
+ jsonObject.put(Keys.MSG, langPropsService.get("removeFailLabel"));
+ }
+ }
+}
diff --git a/src/main/java/org/b3log/solo/processor/console/package-info.java b/src/main/java/org/b3log/solo/processor/console/package-info.java
new file mode 100644
index 00000000..32585efb
--- /dev/null
+++ b/src/main/java/org/b3log/solo/processor/console/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Console requests (Articles, Comments, Preference, etc, management) processing.
+ */
+package org.b3log.solo.processor.console;
diff --git a/src/main/java/org/b3log/solo/processor/package-info.java b/src/main/java/org/b3log/solo/processor/package-info.java
new file mode 100644
index 00000000..22b259e6
--- /dev/null
+++ b/src/main/java/org/b3log/solo/processor/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * HTTP request processing.
+ */
+package org.b3log.solo.processor;
diff --git a/src/main/java/org/b3log/solo/repository/ArchiveDateArticleRepository.java b/src/main/java/org/b3log/solo/repository/ArchiveDateArticleRepository.java
new file mode 100644
index 00000000..bd258056
--- /dev/null
+++ b/src/main/java/org/b3log/solo/repository/ArchiveDateArticleRepository.java
@@ -0,0 +1,135 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see
+ * {
+ * "pagination": {
+ * "paginationPageCount": 88250
+ * },
+ * "rslts": [{
+ * "oId": "",
+ * "archiveDate_oId": "",
+ * "article_oId": ""
+ * }, ....]
+ * }
+ *
+ * @throws RepositoryException repository exception
+ */
+ public JSONObject getByArchiveDateId(final String archiveDateId, final int currentPageNum, final int pageSize) throws RepositoryException {
+ final Query query = new Query().setFilter(new PropertyFilter(ArchiveDate.ARCHIVE_DATE + "_" + Keys.OBJECT_ID, FilterOperator.EQUAL, archiveDateId)).
+ addSort(Article.ARTICLE + "_" + Keys.OBJECT_ID, SortDirection.DESCENDING).
+ setPage(currentPageNum, pageSize).setPageCount(1);
+
+ return get(query);
+ }
+
+ /**
+ * Gets an archive date-article relations by the specified article id.
+ *
+ * @param articleId the specified article id
+ * @return for example
+ *
+ * {
+ * "archiveDate_oId": "",
+ * "article_oId": articleId
+ * }, returns {@code null} if not found
+ *
+ * @throws RepositoryException repository exception
+ */
+ public JSONObject getByArticleId(final String articleId) throws RepositoryException {
+ final Query query = new Query().
+ setFilter(new PropertyFilter(Article.ARTICLE + "_" + Keys.OBJECT_ID, FilterOperator.EQUAL, articleId));
+ final JSONObject result = get(query);
+ final JSONArray array = result.optJSONArray(Keys.RESULTS);
+ if (0 == array.length()) {
+ return null;
+ }
+
+ return array.optJSONObject(0);
+ }
+}
diff --git a/src/main/java/org/b3log/solo/repository/ArchiveDateRepository.java b/src/main/java/org/b3log/solo/repository/ArchiveDateRepository.java
new file mode 100644
index 00000000..af770d4a
--- /dev/null
+++ b/src/main/java/org/b3log/solo/repository/ArchiveDateRepository.java
@@ -0,0 +1,122 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see
+ * {
+ * "pagination": {
+ * "paginationPageCount": 88250
+ * },
+ * "rslts": [{
+ * // article keys....
+ * }, ....]
+ * }
+ *
+ * @throws RepositoryException repository exception
+ */
+ public JSONObject getByAuthorId(final String authorId, final int currentPageNum, final int pageSize) throws RepositoryException {
+ final Query query = new Query().
+ setFilter(CompositeFilterOperator.and(
+ new PropertyFilter(Article.ARTICLE_AUTHOR_ID, FilterOperator.EQUAL, authorId),
+ new PropertyFilter(Article.ARTICLE_STATUS, FilterOperator.EQUAL, Article.ARTICLE_STATUS_C_PUBLISHED))).
+ addSort(Article.ARTICLE_UPDATED, SortDirection.DESCENDING).addSort(Article.ARTICLE_PUT_TOP, SortDirection.DESCENDING).
+ setPage(currentPageNum, pageSize);
+
+ return get(query);
+ }
+
+ /**
+ * Gets an article by the specified permalink.
+ *
+ * @param permalink the specified permalink
+ * @return an article, returns {@code null} if not found
+ * @throws RepositoryException repository exception
+ */
+ public JSONObject getByPermalink(final String permalink) throws RepositoryException {
+ JSONObject ret = articleCache.getArticleByPermalink(permalink);
+ if (null != ret) {
+ return ret;
+ }
+
+ final Query query = new Query().
+ setFilter(new PropertyFilter(Article.ARTICLE_PERMALINK, FilterOperator.EQUAL, permalink)).
+ setPageCount(1);
+
+ final JSONObject result = get(query);
+ final JSONArray array = result.optJSONArray(Keys.RESULTS);
+ if (0 == array.length()) {
+ return null;
+ }
+
+ ret = array.optJSONObject(0);
+ articleCache.putArticle(ret);
+
+ return ret;
+ }
+
+ /**
+ * Gets post articles recently with the specified fetch size.
+ *
+ * @param fetchSize the specified fetch size
+ * @return a list of articles recently, returns an empty list if not found
+ * @throws RepositoryException repository exception
+ */
+ public List
+ * {
+ * "articleTitle": "",
+ * "articlePermalink": "",
+ * "articleAbstract: ""
+ * }
+ *
+ * returns {@code null} if not found
+ * @throws RepositoryException repository exception
+ */
+ public JSONObject getPreviousArticle(final String articleId) throws RepositoryException {
+ final JSONObject currentArticle = get(articleId);
+ if (null == currentArticle) {
+ return null;
+ }
+
+ final long currentArticleCreated = currentArticle.optLong(Article.ARTICLE_CREATED);
+
+ final Query query = new Query().
+ setFilter(CompositeFilterOperator.and(
+ new PropertyFilter(Article.ARTICLE_CREATED, FilterOperator.LESS_THAN, currentArticleCreated),
+ new PropertyFilter(Article.ARTICLE_STATUS, FilterOperator.EQUAL, Article.ARTICLE_STATUS_C_PUBLISHED))).
+ addSort(Article.ARTICLE_CREATED, SortDirection.DESCENDING).
+ setPage(1, 1).setPageCount(1).
+ select(Article.ARTICLE_TITLE, Article.ARTICLE_PERMALINK, Article.ARTICLE_ABSTRACT);
+
+ final JSONObject result = get(query);
+ final JSONArray array = result.optJSONArray(Keys.RESULTS);
+ if (1 != array.length()) {
+ return null;
+ }
+
+ final JSONObject ret = new JSONObject();
+ final JSONObject article = array.optJSONObject(0);
+
+ try {
+ ret.put(Article.ARTICLE_TITLE, article.getString(Article.ARTICLE_TITLE));
+ ret.put(Article.ARTICLE_PERMALINK, article.getString(Article.ARTICLE_PERMALINK));
+ ret.put(Article.ARTICLE_ABSTRACT, article.getString((Article.ARTICLE_ABSTRACT)));
+ } catch (final JSONException e) {
+ throw new RepositoryException(e);
+ }
+
+ return ret;
+ }
+
+ /**
+ * Gets the next article(by create date, oId) by the specified article id.
+ *
+ * @param articleId the specified article id
+ * @return the next article,
+ *
+ * {
+ * "articleTitle": "",
+ * "articlePermalink": "",
+ * "articleAbstract: ""
+ * }
+ *
+ * returns {@code null} if not found
+ * @throws RepositoryException repository exception
+ */
+ public JSONObject getNextArticle(final String articleId) throws RepositoryException {
+ final JSONObject currentArticle = get(articleId);
+ if (null == currentArticle) {
+ return null;
+ }
+
+ final long currentArticleCreated = currentArticle.optLong(Article.ARTICLE_CREATED);
+
+ final Query query = new Query().
+ setFilter(CompositeFilterOperator.and(
+ new PropertyFilter(Article.ARTICLE_CREATED, FilterOperator.GREATER_THAN, currentArticleCreated),
+ new PropertyFilter(Article.ARTICLE_STATUS, FilterOperator.EQUAL, Article.ARTICLE_STATUS_C_PUBLISHED))).
+ addSort(Article.ARTICLE_CREATED, SortDirection.ASCENDING).
+ setPage(1, 1).setPageCount(1).
+ select(Article.ARTICLE_TITLE, Article.ARTICLE_PERMALINK, Article.ARTICLE_ABSTRACT);
+
+ final JSONObject result = get(query);
+ final JSONArray array = result.optJSONArray(Keys.RESULTS);
+ if (1 != array.length()) {
+ return null;
+ }
+
+ final JSONObject ret = new JSONObject();
+ final JSONObject article = array.optJSONObject(0);
+
+ try {
+ ret.put(Article.ARTICLE_TITLE, article.getString(Article.ARTICLE_TITLE));
+ ret.put(Article.ARTICLE_PERMALINK, article.getString(Article.ARTICLE_PERMALINK));
+ ret.put(Article.ARTICLE_ABSTRACT, article.getString((Article.ARTICLE_ABSTRACT)));
+ } catch (final JSONException e) {
+ throw new RepositoryException(e);
+ }
+
+ return ret;
+ }
+
+ /**
+ * Determines an article specified by the given article id is published.
+ *
+ * @param articleId the given article id
+ * @return {@code true} if it is published, {@code false} otherwise
+ * @throws RepositoryException repository exception
+ */
+ public boolean isPublished(final String articleId) throws RepositoryException {
+ final JSONObject article = get(articleId);
+ if (null == article) {
+ return false;
+ }
+
+ return Article.ARTICLE_STATUS_C_PUBLISHED == article.optInt(Article.ARTICLE_STATUS);
+ }
+}
diff --git a/src/main/java/org/b3log/solo/repository/CategoryRepository.java b/src/main/java/org/b3log/solo/repository/CategoryRepository.java
new file mode 100644
index 00000000..fceeb9c2
--- /dev/null
+++ b/src/main/java/org/b3log/solo/repository/CategoryRepository.java
@@ -0,0 +1,201 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see
+ * {
+ * "pagination": {
+ * "paginationPageCount": 88250
+ * },
+ * "rslts": [{
+ * "oId": "",
+ * "category_oId": categoryId,
+ * "tag_oId": ""
+ * }, ....]
+ * }
+ *
+ * @throws RepositoryException repository exception
+ */
+ public JSONObject getByCategoryId(final String categoryId, final int currentPageNum, final int pageSize) throws RepositoryException {
+ final Query query = new Query().setFilter(new PropertyFilter(Category.CATEGORY + "_" + Keys.OBJECT_ID, FilterOperator.EQUAL, categoryId)).
+ setPage(currentPageNum, pageSize).setPageCount(1);
+
+ return get(query);
+ }
+
+ /**
+ * Gets category-tag relations by the specified tag id.
+ *
+ * @param tagId the specified tag id
+ * @param currentPageNum the specified current page number, MUST greater then {@code 0}
+ * @param pageSize the specified page size(count of a page contains objects), MUST greater then {@code 0}
+ * @return for example
+ * {
+ * "pagination": {
+ * "paginationPageCount": 88250
+ * },
+ * "rslts": [{
+ * "oId": "",
+ * "category_oId": "",
+ * "tag_oId": tagId
+ * }, ....]
+ * }
+ *
+ * @throws RepositoryException repository exception
+ */
+ public JSONObject getByTagId(final String tagId, final int currentPageNum, final int pageSize) throws RepositoryException {
+ final Query query = new Query().setFilter(new PropertyFilter(Tag.TAG + "_" + Keys.OBJECT_ID, FilterOperator.EQUAL, tagId)).
+ setPage(currentPageNum, pageSize).setPageCount(1);
+
+ return get(query);
+ }
+
+ /**
+ * Removes category-tag relations by the specified category id.
+ *
+ * @param categoryId the specified category id
+ * @throws RepositoryException repository exception
+ */
+ public void removeByCategoryId(final String categoryId) throws RepositoryException {
+ final Query query = new Query().setFilter(new PropertyFilter(Category.CATEGORY + "_" + Keys.OBJECT_ID, FilterOperator.EQUAL, categoryId));
+ final JSONArray relations = get(query).optJSONArray(Keys.RESULTS);
+ for (int i = 0; i < relations.length(); i++) {
+ final JSONObject rel = relations.optJSONObject(i);
+ remove(rel.optString(Keys.OBJECT_ID));
+ }
+ }
+
+ /**
+ * Removes category-tag relations by the specified tag id.
+ *
+ * @param tagId the specified tag id
+ * @throws RepositoryException repository exception
+ */
+ public void removeByTagId(final String tagId) throws RepositoryException {
+ final Query query = new Query().setFilter(new PropertyFilter(Tag.TAG + "_" + Keys.OBJECT_ID, FilterOperator.EQUAL, tagId));
+ final JSONArray relations = get(query).optJSONArray(Keys.RESULTS);
+ for (int i = 0; i < relations.length(); i++) {
+ final JSONObject rel = relations.optJSONObject(i);
+ remove(rel.optString(Keys.OBJECT_ID));
+ }
+ }
+}
diff --git a/src/main/java/org/b3log/solo/repository/CommentRepository.java b/src/main/java/org/b3log/solo/repository/CommentRepository.java
new file mode 100644
index 00000000..61097de7
--- /dev/null
+++ b/src/main/java/org/b3log/solo/repository/CommentRepository.java
@@ -0,0 +1,175 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see + * All options with the specified category will be merged into one json object as the return value. + *
+ * + * @param category the specified category + * @return all options with the specified category, for example, + *
+ * {
+ * "${optionId}": "${optionValue}",
+ * ....
+ * }
+ * , returns {@code null} if not found
+ * @throws RepositoryException repository exception
+ */
+ public JSONObject getOptions(final String category) throws RepositoryException {
+ final JSONObject cached = optionCache.getCategory(category);
+ if (null != cached) {
+ return cached;
+ }
+
+ final JSONObject ret = new JSONObject();
+ try {
+ final List
+ * [{
+ * "oId": "",
+ * "tag_oId": "",
+ * "article_oId": articleId
+ * }, ....], returns an empty list if not found
+ *
+ * @throws RepositoryException repository exception
+ */
+ public List
+ * {
+ * "pagination": {
+ * "paginationPageCount": 88250
+ * },
+ * "rslts": [{
+ * "oId": "",
+ * "tag_oId": tagId,
+ * "article_oId": ""
+ * }, ....]
+ * }
+ *
+ * @throws RepositoryException repository exception
+ */
+ public JSONObject getByTagId(final String tagId, final int currentPageNum, final int pageSize) throws RepositoryException {
+ final Query query = new Query().setFilter(new PropertyFilter(Tag.TAG + "_" + Keys.OBJECT_ID, FilterOperator.EQUAL, tagId)).
+ addSort(Article.ARTICLE + "_" + Keys.OBJECT_ID, SortDirection.DESCENDING).
+ setPage(currentPageNum, pageSize);
+
+ return get(query);
+ }
+}
diff --git a/src/main/java/org/b3log/solo/repository/TagRepository.java b/src/main/java/org/b3log/solo/repository/TagRepository.java
new file mode 100644
index 00000000..8854d8f6
--- /dev/null
+++ b/src/main/java/org/b3log/solo/repository/TagRepository.java
@@ -0,0 +1,96 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see
+ * {
+ * "archiveDate": {
+ * "oId": "",
+ * "archiveTime": "",
+ * "archiveDatePublishedArticleCount": int
+ * }
+ * }
+ * , returns {@code null} if not found
+ * @throws ServiceException service exception
+ */
+ public JSONObject getByArchiveDateString(final String archiveDateString) throws ServiceException {
+ final JSONObject ret = new JSONObject();
+
+ try {
+ final JSONObject archiveDate = archiveDateRepository.getByArchiveDate(archiveDateString);
+ if (null == archiveDate) {
+ return null;
+ }
+
+ final int articleCount = archiveDateArticleRepository.getPublishedArticleCount(archiveDate.optString(Keys.OBJECT_ID));
+ archiveDate.put(ArchiveDate.ARCHIVE_DATE_T_PUBLISHED_ARTICLE_COUNT, articleCount);
+ ret.put(ArchiveDate.ARCHIVE_DATE, archiveDate);
+
+ return ret;
+ } catch (final RepositoryException e) {
+ LOGGER.log(Level.ERROR, "Gets archive date[string=" + archiveDateString + "] failed", e);
+ throw new ServiceException("Gets archive date[string=" + archiveDateString + "] failed");
+ }
+ }
+}
diff --git a/src/main/java/org/b3log/solo/service/ArticleMgmtService.java b/src/main/java/org/b3log/solo/service/ArticleMgmtService.java
new file mode 100644
index 00000000..3cf71354
--- /dev/null
+++ b/src/main/java/org/b3log/solo/service/ArticleMgmtService.java
@@ -0,0 +1,1048 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see + *
-
+ *
- Un-tags old article, decrements tag reference count + *
- Removes old article-tag relations + *
- Saves new article-tag relations with tag reference count + *
+ * Removes all relations if not specified the tag ids. + *
+ * + * @param articleId the specified article id + * @param tagIds the specified tag ids of the relations to be removed + * @throws JSONException json exception + * @throws RepositoryException repository exception + */ + private void removeTagArticleRelations(final String articleId, final String... tagIds) throws JSONException, RepositoryException { + final List+ * Some properties of an article are not been changed while article + * updating, these properties are called 'auto' properties. + *
+ *+ * The property(named {@value org.b3log.solo.model.Article#ARTICLE_RANDOM_DOUBLE}) of the specified + * article will be regenerated. + *
+ * + * @param oldArticle the specified old article + * @param article the specified article + * @throws JSONException json exception + */ + private void fillAutoProperties(final JSONObject oldArticle, final JSONObject article) throws JSONException { + final long created = oldArticle.getLong(ARTICLE_CREATED); + article.put(ARTICLE_CREATED, created); + article.put(ARTICLE_COMMENT_COUNT, oldArticle.getInt(ARTICLE_COMMENT_COUNT)); + article.put(ARTICLE_VIEW_COUNT, oldArticle.getInt(ARTICLE_VIEW_COUNT)); + article.put(ARTICLE_PUT_TOP, oldArticle.getBoolean(ARTICLE_PUT_TOP)); + article.put(ARTICLE_AUTHOR_ID, oldArticle.getString(ARTICLE_AUTHOR_ID)); + article.put(ARTICLE_RANDOM_DOUBLE, Math.random()); + } + + /** + * Gets article permalink for adding article with the specified article. + * + * @param article the specified article + * @return permalink + * @throws ServiceException if invalid permalink occurs + */ + private String getPermalinkForAddArticle(final JSONObject article) throws ServiceException { + final long date = article.optLong(Article.ARTICLE_CREATED); + String ret = article.optString(Article.ARTICLE_PERMALINK); + if (StringUtils.isBlank(ret)) { + ret = "/articles/" + DateFormatUtils.format(date, "yyyy/MM/dd") + "/" + article.optString(Keys.OBJECT_ID) + ".html"; + } + + if (!ret.startsWith("/")) { + ret = "/" + ret; + } + + if (PermalinkQueryService.invalidArticlePermalinkFormat(ret)) { + throw new ServiceException(langPropsService.get("invalidPermalinkFormatLabel")); + } + + if (permalinkQueryService.exist(ret)) { + throw new ServiceException(langPropsService.get("duplicatedPermalinkLabel")); + } + + return ret.replaceAll(" ", "-"); + } + + /** + * Gets article permalink for updating article with the specified old article, article, created at. + * + * @param oldArticle the specified old article + * @param article the specified article + * @param created the specified created + * @return permalink + * @throws ServiceException if invalid permalink occurs + * @throws JSONException json exception + */ + private String getPermalinkForUpdateArticle(final JSONObject oldArticle, final JSONObject article, final long created) + throws ServiceException, JSONException { + final String articleId = article.getString(Keys.OBJECT_ID); + String ret = article.optString(ARTICLE_PERMALINK).trim(); + final String oldPermalink = oldArticle.getString(ARTICLE_PERMALINK); + + if (!oldPermalink.equals(ret)) { + if (StringUtils.isBlank(ret)) { + ret = "/articles/" + DateFormatUtils.format(created, "yyyy/MM/dd") + "/" + articleId + ".html"; + } + + if (!ret.startsWith("/")) { + ret = "/" + ret; + } + + if (PermalinkQueryService.invalidArticlePermalinkFormat(ret)) { + throw new ServiceException(langPropsService.get("invalidPermalinkFormatLabel")); + } + + if (!oldPermalink.equals(ret) && permalinkQueryService.exist(ret)) { + throw new ServiceException(langPropsService.get("duplicatedPermalinkLabel")); + } + } + + return ret.replaceAll(" ", "-"); + } + + /** + * Determines whether the specified tag title exists in the specified tags. + * + * @param tagTitle the specified tag title + * @param tags the specified tags + * @return {@code true} if it exists, {@code false} otherwise + * @throws JSONException json exception + */ + private static boolean tagExists(final String tagTitle, final List+ * The specified article has a property {@value Article#ARTICLE_AUTHOR_ID}, this method will use this property to + * get a user from users. + *
+ *+ * If can't find the specified article's author (i.e. the author has been removed by administrator), returns + * administrator. + *
+ * + * @param article the specified article + * @return user, {@code null} if not found + * @throws ServiceException service exception + */ + public JSONObject getAuthor(final JSONObject article) throws ServiceException { + try { + final String userId = article.getString(Article.ARTICLE_AUTHOR_ID); + JSONObject ret = userRepository.get(userId); + if (null == ret) { + LOGGER.log(Level.WARN, "Gets author of article failed, assumes the administrator is the author of this article [id={0}]", + article.getString(Keys.OBJECT_ID)); + // This author may be deleted by admin, use admin as the author of this article + ret = userRepository.getAdmin(); + } + + return ret; + } catch (final Exception e) { + LOGGER.log(Level.ERROR, "Gets author of article [id={0}] failed", article.optString(Keys.OBJECT_ID)); + + throw new ServiceException(e); + } + } + + /** + * Gets the sign of an article specified by the sign id. + * + * @param signId the specified article id + * @param preference the specified preference + * @return article sign, returns the default sign (which oId is "1") if not found + * @throws JSONException json exception + */ + public JSONObject getSign(final String signId, final JSONObject preference) throws JSONException { + final JSONArray signs = new JSONArray(preference.getString(Option.ID_C_SIGNS)); + JSONObject defaultSign = null; + for (int i = 0; i < signs.length(); i++) { + final JSONObject ret = signs.getJSONObject(i); + + if (signId.equals(ret.optString(Keys.OBJECT_ID))) { + return ret; + } + + if ("1".equals(ret.optString(Keys.OBJECT_ID))) { + defaultSign = ret; + } + } + + LOGGER.log(Level.WARN, "Can not find the sign [id={0}], returns a default sign [id=1]", signId); + + return defaultSign; + } + + /** + * Determines the specified article has updated. + * + * @param article the specified article + * @return {@code true} if it has updated, {@code false} otherwise + * @throws JSONException json exception + */ + public boolean hasUpdated(final JSONObject article) throws JSONException { + final long updateDate = article.getLong(Article.ARTICLE_UPDATED); + final long createDate = article.getLong(Article.ARTICLE_CREATED); + + return createDate != updateDate; + } + + /** + * Gets the recent articles with the specified fetch size. + * + * @param fetchSize the specified fetch size + * @return a list of json object, its size less or equal to the specified fetch size + */ + public List+ * Note: The article content and abstract is raw (no editor type processing). + *
+ * + * @param articleId the specified article id + * @return for example,
+ * {
+ * "article": {
+ * "oId": "",
+ * "articleTitle": "",
+ * "articleAbstract": "",
+ * "articleContent": "",
+ * "articlePermalink": "",
+ * "articleCreateDate": java.util.Date,
+ * "articleTags": [{
+ * "oId": "",
+ * "tagTitle": ""
+ * }, ....],
+ * "articleSignId": "",
+ * "articleViewPwd": "",
+ * "signs": [{
+ * "oId": "",
+ * "signHTML": ""
+ * }, ....]
+ * }
+ * }
+ * , returns {@code null} if not found
+ * @throws ServiceException service exception
+ */
+ public JSONObject getArticle(final String articleId) throws ServiceException {
+ try {
+ final JSONObject ret = new JSONObject();
+ final JSONObject article = articleRepository.get(articleId);
+ if (null == article) {
+ return null;
+ }
+
+ ret.put(Article.ARTICLE, article);
+
+ // Tags
+ final JSONArray tags = new JSONArray();
+ final List+ * Specified the "excludes" for results properties exclusion. + *
+ * + * @param requestJSONObject the specified request json object, for example, + * "paginationCurrentPageNum": 1, + * "paginationPageSize": 20, + * "paginationWindowSize": 10, + * "articleStatus": int, + * "keyword": "", // Optional search keyword + * "excludes": ["", ....], // Optional + * "enableArticleUpdateHint": bool // Optional + * see {@link Pagination} for more details + * @return for example,
+ * {
+ * "pagination": {
+ * "paginationPageCount": 100,
+ * "paginationPageNums": [1, 2, 3, 4, 5]
+ * },
+ * "articles": [{
+ * "oId": "",
+ * "articleTitle": "",
+ * "articleCommentCount": int,
+ * "articleCreateTime"; long,
+ * "articleViewCount": int,
+ * "articleTags": "tag1, tag2, ....",
+ * "articlePutTop": boolean,
+ * "articleSignId": "",
+ * "articleViewPwd": "",
+ * .... // Specified by the "excludes"
+ * }, ....]
+ * }
+ * , order by article update date and sticky(put top).
+ * @see Pagination
+ */
+ public JSONObject getArticles(final JSONObject requestJSONObject) {
+ final JSONObject ret = new JSONObject();
+
+ try {
+ final int currentPageNum = requestJSONObject.getInt(Pagination.PAGINATION_CURRENT_PAGE_NUM);
+ final int pageSize = requestJSONObject.getInt(Pagination.PAGINATION_PAGE_SIZE);
+ final int windowSize = requestJSONObject.getInt(Pagination.PAGINATION_WINDOW_SIZE);
+ final int articleStatus = requestJSONObject.optInt(Article.ARTICLE_STATUS, Article.ARTICLE_STATUS_C_PUBLISHED);
+
+ final Query query = new Query().setPage(currentPageNum, pageSize).
+ addSort(Article.ARTICLE_PUT_TOP, SortDirection.DESCENDING);
+ if (requestJSONObject.optBoolean(Option.ID_C_ENABLE_ARTICLE_UPDATE_HINT)) {
+ query.addSort(Article.ARTICLE_UPDATED, SortDirection.DESCENDING);
+ } else {
+ query.addSort(Article.ARTICLE_CREATED, SortDirection.DESCENDING);
+ }
+ final String keyword = requestJSONObject.optString(Common.KEYWORD);
+ if (StringUtils.isBlank(keyword)) {
+ query.setFilter(new PropertyFilter(Article.ARTICLE_STATUS, FilterOperator.EQUAL, articleStatus));
+ } else {
+ query.setFilter(CompositeFilterOperator.and(
+ new PropertyFilter(Article.ARTICLE_STATUS, FilterOperator.EQUAL, articleStatus),
+ CompositeFilterOperator.or(
+ new PropertyFilter(Article.ARTICLE_TITLE, FilterOperator.LIKE, "%" + keyword + "%"),
+ new PropertyFilter(Article.ARTICLE_TAGS_REF, FilterOperator.LIKE, "%" + keyword + "%")
+ )
+ ));
+ }
+
+ final JSONObject result = articleRepository.get(query);
+ final int pageCount = result.optJSONObject(Pagination.PAGINATION).optInt(Pagination.PAGINATION_PAGE_COUNT);
+ final JSONObject pagination = new JSONObject();
+ ret.put(Pagination.PAGINATION, pagination);
+ final List+ * Note: The article content and abstract is raw (no editor type processing). + *
+ * + * @param fetchSize the specified fetch size + * @return a list of json objects, its size less or equal to the specified fetch size + * @throws ServiceException service exception + */ + public List+ * Note: The article content and abstract is raw (no editor type processing). + *
+ * + * @param article the specified article + * @param preference the specified preference + * @return a list of articles, returns an empty list if not found + */ + public List+ * Note: The article content and abstract is raw (no editor type processing). + *
+ * + * @param articleId the specified article id + * @return the previous article,
+ * {
+ * "articleTitle": "",
+ * "articlePermalink": "",
+ * "articleAbstract": ""
+ * }
+ * returns {@code null} if not found
+ * @throws ServiceException service exception
+ */
+ public JSONObject getNextArticle(final String articleId) throws ServiceException {
+ try {
+ return articleRepository.getNextArticle(articleId);
+ } catch (final RepositoryException e) {
+ LOGGER.log(Level.ERROR, "Gets the next article failed[articleId=" + articleId + "]", e);
+ throw new ServiceException(e);
+ }
+ }
+
+ /**
+ * Gets the previous article(by create date) by the specified article id.
+ * + * Note: The article content and abstract is raw (no editor type processing). + *
+ * + * @param articleId the specified article id + * @return the previous article,
+ * {
+ * "articleTitle": "",
+ * "articlePermalink": "",
+ * "articleAbstract": ""
+ * }
+ * returns {@code null} if not found
+ * @throws ServiceException service exception
+ */
+ public JSONObject getPreviousArticle(final String articleId) throws ServiceException {
+ try {
+ return articleRepository.getPreviousArticle(articleId);
+ } catch (final RepositoryException e) {
+ LOGGER.log(Level.ERROR, "Gets the previous article failed[articleId=" + articleId + "]", e);
+ throw new ServiceException(e);
+ }
+ }
+
+ /**
+ * Gets an article by the specified article id.
+ * + * Note: The article content and abstract is raw (no editor type processing). + *
+ * + * @param articleId the specified article id + * @return an article, returns {@code null} if not found + */ + public JSONObject getArticleById(final String articleId) { + try { + return articleRepository.get(articleId); + } catch (final RepositoryException e) { + LOGGER.log(Level.ERROR, "Gets an article [id=" + articleId + "] failed", e); + + return null; + } + } + + /** + * Gets published articles by the specified author id, current page number and page size. + * + * @param authorId the specified author id + * @param currentPageNum the specified current page number + * @param pageSize the specified page size + * @return result + * @throws ServiceException service exception + */ + public JSONObject getArticlesByAuthorId(final String authorId, final int currentPageNum, final int pageSize) throws ServiceException { + try { + final JSONObject ret = articleRepository.getByAuthorId(authorId, currentPageNum, pageSize); + final JSONArray articles = ret.getJSONArray(Keys.RESULTS); + for (int i = 0; i < articles.length(); i++) { + final JSONObject article = articles.getJSONObject(i); + article.put(Article.ARTICLE_CREATE_TIME, article.getLong(Article.ARTICLE_CREATED)); + article.put(Article.ARTICLE_T_CREATE_DATE, new Date(article.optLong(Article.ARTICLE_CREATED))); + article.put(Article.ARTICLE_T_UPDATE_DATE, new Date(article.optLong(Article.ARTICLE_UPDATED))); + } + + return ret; + } catch (final Exception e) { + LOGGER.log(Level.ERROR, "Gets articles by author id failed [authorId=" + authorId + ", currentPageNum=" + currentPageNum + ", pageSize=" + pageSize + "]", e); + + throw new ServiceException(e); + } + } + + /** + * Gets article contents with the specified article id. + *+ * Invoking this method dose not effect on article view count. + *
+ * + * @param context the specified HTTP servlet request context + * @param articleId the specified article id + * @return article contents, returns {@code null} if not found + * @throws ServiceException service exception + */ + public String getArticleContent(final RequestContext context, final String articleId) throws ServiceException { + if (StringUtils.isBlank(articleId)) { + return null; + } + + try { + final JSONObject article = articleRepository.get(articleId); + if (null == article) { + return null; + } + + if (null != context && Solos.needViewPwd(context, article)) { + final String content = langPropsService.get("articleContentPwd"); + article.put(Article.ARTICLE_CONTENT, content); + } else { + // Markdown to HTML for content and abstract + Stopwatchs.start("Get Article Content [Markdown]"); + String content = article.optString(Article.ARTICLE_CONTENT); + content = Markdowns.toHTML(content); + article.put(Article.ARTICLE_CONTENT, content); + Stopwatchs.end(); + } + + return article.getString(Article.ARTICLE_CONTENT); + } catch (final Exception e) { + LOGGER.log(Level.ERROR, "Gets article content failed[articleId=" + articleId + "]", e); + + throw new ServiceException(e); + } + } + + /** + * Converts the content and abstract for each of the specified articles to HTML if that is saved by Markdown editor. + * + * @param articles the specified articles + */ + public void markdowns(final List+ * Remains the following properties: + *
-
+ *
- {@link Article#ARTICLE_TITLE article title} + *
- {@link Article#ARTICLE_PERMALINK article permalink} + *
+ * The batch version of method {@link #removeUnusedProperties(org.json.JSONObject)}. + *
+ * + * @param articles the specified articles + * @see #removeUnusedProperties(org.json.JSONObject) + */ + private void removeUnusedProperties(final List+ * Remains the following properties: + *
-
+ *
- {@link Article#ARTICLE_TITLE article title} + *
- {@link Article#ARTICLE_PERMALINK article permalink} + *
+ * {
+ * "pagination": {
+ * "paginationPageCount": 100,
+ * "paginationPageNums": [1, 2, 3, 4, 5]
+ * },
+ * "categories": [{
+ * "oId": "",
+ * "categoryTitle": "",
+ * "categoryDescription": "",
+ * ....
+ * }, ....]
+ * }
+ *
+ * @throws ServiceException service exception
+ * @see Pagination
+ */
+ public JSONObject getCategoris(final JSONObject requestJSONObject) throws ServiceException {
+ final JSONObject ret = new JSONObject();
+
+ final int currentPageNum = requestJSONObject.optInt(Pagination.PAGINATION_CURRENT_PAGE_NUM);
+ final int pageSize = requestJSONObject.optInt(Pagination.PAGINATION_PAGE_SIZE);
+ final int windowSize = requestJSONObject.optInt(Pagination.PAGINATION_WINDOW_SIZE);
+ final Query query = new Query().setPage(currentPageNum, pageSize).
+ addSort(Category.CATEGORY_ORDER, SortDirection.ASCENDING).
+ addSort(Category.CATEGORY_TAG_CNT, SortDirection.DESCENDING).
+ addSort(Keys.OBJECT_ID, SortDirection.DESCENDING);
+
+ if (requestJSONObject.has(Category.CATEGORY_TITLE)) {
+ query.setFilter(new PropertyFilter(Category.CATEGORY_TITLE, FilterOperator.EQUAL,
+ requestJSONObject.optString(Category.CATEGORY_TITLE)));
+ }
+
+ JSONObject result;
+ try {
+ result = categoryRepository.get(query);
+ } catch (final RepositoryException e) {
+ LOGGER.log(Level.ERROR, "Gets categories failed", e);
+
+ throw new ServiceException(e);
+ }
+
+ final int pageCount = result.optJSONObject(Pagination.PAGINATION).optInt(Pagination.PAGINATION_PAGE_COUNT);
+
+ final JSONObject pagination = new JSONObject();
+ ret.put(Pagination.PAGINATION, pagination);
+ final List+ * XSS process (name) in this method. + *
+ * + * @param requestJSONObject the specified comment adding request, for example, + * { + * "type": "", // "article" + * "oId": "", + * "commentName": "", + * "commentURL": "", + * "commentContent": "", + * } + * @return check result, for example,
+ * {
+ * "sc": boolean,
+ * "msg": "" // Exists if "sc" equals to false
+ * }
+ *
+ */
+ public JSONObject checkAddCommentRequest(final JSONObject requestJSONObject) {
+ final JSONObject ret = new JSONObject();
+
+ try {
+ ret.put(Keys.STATUS_CODE, false);
+ final JSONObject preference = optionQueryService.getPreference();
+
+ if (null == preference || !preference.optBoolean(Option.ID_C_COMMENTABLE)) {
+ ret.put(Keys.MSG, langPropsService.get("notAllowCommentLabel"));
+
+ return ret;
+ }
+
+ final String id = requestJSONObject.optString(Keys.OBJECT_ID);
+ final String type = requestJSONObject.optString(Common.TYPE);
+
+ if (Article.ARTICLE.equals(type)) {
+ final JSONObject article = articleRepository.get(id);
+
+ if (null == article || !article.optBoolean(Article.ARTICLE_COMMENTABLE)) {
+ ret.put(Keys.MSG, langPropsService.get("notAllowCommentLabel"));
+
+ return ret;
+ }
+ } else {
+ ret.put(Keys.MSG, langPropsService.get("notAllowCommentLabel"));
+
+ return ret;
+ }
+
+ String commentName = requestJSONObject.getString(Comment.COMMENT_NAME);
+ if (MAX_COMMENT_NAME_LENGTH < commentName.length() || MIN_COMMENT_NAME_LENGTH > commentName.length()) {
+ LOGGER.log(Level.WARN, "Comment name is too long [{0}]", commentName);
+ ret.put(Keys.MSG, langPropsService.get("nameTooLongLabel"));
+
+ return ret;
+ }
+
+ final JSONObject commenter = userRepository.getByUserName(commentName);
+ if (null == commenter) {
+ LOGGER.log(Level.WARN, "Not found user [" + commentName + "]");
+ ret.put(Keys.MSG, langPropsService.get("queryUserFailedLabel"));
+
+ return ret;
+ }
+
+ final String commentURL = requestJSONObject.optString(Comment.COMMENT_URL);
+
+ if (!Strings.isURL(commentURL) || StringUtils.contains(commentURL, "<")) {
+ requestJSONObject.put(Comment.COMMENT_URL, "");
+ }
+
+ String commentContent = requestJSONObject.optString(Comment.COMMENT_CONTENT);
+
+ if (MAX_COMMENT_CONTENT_LENGTH < commentContent.length() || MIN_COMMENT_CONTENT_LENGTH > commentContent.length()) {
+ LOGGER.log(Level.WARN, "Comment conent length is invalid[{0}]", commentContent.length());
+ ret.put(Keys.MSG, langPropsService.get("commentContentCannotEmptyLabel"));
+
+ return ret;
+ }
+
+ ret.put(Keys.STATUS_CODE, true);
+ requestJSONObject.put(Comment.COMMENT_CONTENT, commentContent);
+
+ return ret;
+ } catch (final Exception e) {
+ LOGGER.log(Level.WARN, "Checks add comment request[" + requestJSONObject.toString() + "] failed", e);
+
+ ret.put(Keys.STATUS_CODE, false);
+ ret.put(Keys.MSG, langPropsService.get("addFailLabel"));
+
+ return ret;
+ }
+ }
+
+ /**
+ * Adds an article comment with the specified request json object.
+ *
+ * @param requestJSONObject the specified request json object, for example,
+ * {
+ * "oId": "", // article id
+ * "commentName": "",
+ * "commentURL": "", // optional
+ * "commentContent": "",
+ * "commentOriginalCommentId": "" // optional
+ * }
+ * @return add result, for example,
+ * {
+ * "oId": "", // generated comment id
+ * "commentDate": "", // format: yyyy-MM-dd HH:mm:ss
+ * "commentOriginalCommentName": "" // optional, corresponding to argument "commentOriginalCommentId"
+ * "commentThumbnailURL": "",
+ * "commentSharpURL": "",
+ * "commentContent": "",
+ * "commentName": "",
+ * "commentURL": "", // optional
+ * "isReply": boolean,
+ * "article": {},
+ * "commentOriginalCommentId": "", // optional
+ * "commentable": boolean,
+ * "permalink": "" // article.articlePermalink
+ * }
+ *
+ * @throws ServiceException service exception
+ */
+ public JSONObject addArticleComment(final JSONObject requestJSONObject) throws ServiceException {
+ final JSONObject ret = new JSONObject();
+ ret.put(Common.IS_REPLY, false);
+
+ final Transaction transaction = commentRepository.beginTransaction();
+
+ try {
+ final String articleId = requestJSONObject.getString(Keys.OBJECT_ID);
+ final JSONObject article = articleRepository.get(articleId);
+ ret.put(Article.ARTICLE, article);
+ final String commentName = requestJSONObject.getString(Comment.COMMENT_NAME);
+ final String commentURL = requestJSONObject.optString(Comment.COMMENT_URL);
+ final String commentContent = requestJSONObject.getString(Comment.COMMENT_CONTENT);
+ final String originalCommentId = requestJSONObject.optString(Comment.COMMENT_ORIGINAL_COMMENT_ID);
+ ret.put(Comment.COMMENT_ORIGINAL_COMMENT_ID, originalCommentId);
+ final JSONObject comment = new JSONObject();
+ comment.put(Comment.COMMENT_ORIGINAL_COMMENT_ID, "");
+ comment.put(Comment.COMMENT_ORIGINAL_COMMENT_NAME, "");
+ comment.put(Comment.COMMENT_NAME, commentName);
+ comment.put(Comment.COMMENT_URL, commentURL);
+ comment.put(Comment.COMMENT_CONTENT, commentContent);
+ comment.put(Comment.COMMENT_ORIGINAL_COMMENT_ID, requestJSONObject.optString(Comment.COMMENT_ORIGINAL_COMMENT_ID));
+ comment.put(Comment.COMMENT_ORIGINAL_COMMENT_NAME, requestJSONObject.optString(Comment.COMMENT_ORIGINAL_COMMENT_NAME));
+ final JSONObject preference = optionQueryService.getPreference();
+ final Date date = new Date();
+ comment.put(Comment.COMMENT_CREATED, date.getTime());
+ ret.put(Comment.COMMENT_T_DATE, DateFormatUtils.format(date, "yyyy-MM-dd HH:mm:ss"));
+ ret.put("commentDate2", date);
+ ret.put(Common.COMMENTABLE, preference.getBoolean(Option.ID_C_COMMENTABLE) && article.getBoolean(Article.ARTICLE_COMMENTABLE));
+ ret.put(Common.PERMALINK, article.getString(Article.ARTICLE_PERMALINK));
+ ret.put(Comment.COMMENT_NAME, commentName);
+ String cmtContent = Markdowns.toHTML(commentContent);
+ cmtContent = Markdowns.clean(cmtContent);
+ ret.put(Comment.COMMENT_CONTENT, cmtContent);
+ ret.put(Comment.COMMENT_URL, commentURL);
+
+ JSONObject originalComment;
+ if (StringUtils.isNotBlank(originalCommentId)) {
+ originalComment = commentRepository.get(originalCommentId);
+ if (null != originalComment) {
+ comment.put(Comment.COMMENT_ORIGINAL_COMMENT_ID, originalCommentId);
+ final String originalCommentName = originalComment.getString(Comment.COMMENT_NAME);
+
+ comment.put(Comment.COMMENT_ORIGINAL_COMMENT_NAME, originalCommentName);
+ ret.put(Comment.COMMENT_ORIGINAL_COMMENT_NAME, originalCommentName);
+
+ ret.put(Common.IS_REPLY, true);
+ } else {
+ LOGGER.log(Level.WARN, "Not found orginal comment[id={0}] of reply[name={1}, content={2}]",
+ originalCommentId, commentName, commentContent);
+ }
+ }
+ setCommentThumbnailURL(comment);
+ ret.put(Comment.COMMENT_THUMBNAIL_URL, comment.getString(Comment.COMMENT_THUMBNAIL_URL));
+ comment.put(Comment.COMMENT_ON_ID, articleId);
+ final String commentId = Ids.genTimeMillisId();
+ comment.put(Keys.OBJECT_ID, commentId);
+ ret.put(Keys.OBJECT_ID, commentId);
+ final String commentSharpURL = Comment.getCommentSharpURLForArticle(article, commentId);
+ comment.put(Comment.COMMENT_SHARP_URL, commentSharpURL);
+ ret.put(Comment.COMMENT_SHARP_URL, commentSharpURL);
+
+ commentRepository.add(comment);
+ articleMgmtService.incArticleCommentCount(articleId);
+
+ final JSONObject eventData = new JSONObject();
+ eventData.put(Comment.COMMENT, comment);
+ eventData.put(Article.ARTICLE, article);
+ eventManager.fireEventAsynchronously(new Event<>(EventTypes.ADD_COMMENT_TO_ARTICLE, eventData));
+
+ transaction.commit();
+ } catch (final Exception e) {
+ if (transaction.isActive()) {
+ transaction.rollback();
+ }
+
+ throw new ServiceException(e);
+ }
+
+ return ret;
+ }
+
+ /**
+ * Removes a comment of an article with the specified comment id.
+ *
+ * @param commentId the given comment id
+ * @throws ServiceException service exception
+ */
+ public void removeArticleComment(final String commentId) throws ServiceException {
+ final Transaction transaction = commentRepository.beginTransaction();
+
+ try {
+ final JSONObject comment = commentRepository.get(commentId);
+ final String articleId = comment.getString(Comment.COMMENT_ON_ID);
+ commentRepository.remove(commentId);
+ decArticleCommentCount(articleId);
+
+ transaction.commit();
+ } catch (final Exception e) {
+ if (transaction.isActive()) {
+ transaction.rollback();
+ }
+
+ LOGGER.log(Level.ERROR, "Removes a comment of an article failed", e);
+ throw new ServiceException(e);
+ }
+ }
+
+ /**
+ * Article comment count -1 for an article specified by the given article id.
+ *
+ * @param articleId the given article id
+ * @throws JSONException json exception
+ * @throws RepositoryException repository exception
+ */
+ private void decArticleCommentCount(final String articleId) throws JSONException, RepositoryException {
+ final JSONObject article = articleRepository.get(articleId);
+ final JSONObject newArticle = new JSONObject(article, JSONObject.getNames(article));
+ final int commentCnt = article.getInt(Article.ARTICLE_COMMENT_COUNT);
+ newArticle.put(Article.ARTICLE_COMMENT_COUNT, commentCnt - 1);
+ articleRepository.update(articleId, newArticle, Article.ARTICLE_COMMENT_COUNT);
+ }
+
+ /**
+ * Sets commenter thumbnail URL for the specified comment.
+ *
+ * @param comment the specified comment
+ * @throws Exception exception
+ */
+ public void setCommentThumbnailURL(final JSONObject comment) throws Exception {
+ final String commenterName = comment.optString(Comment.COMMENT_NAME);
+ final JSONObject commenter = userRepository.getByUserName(commenterName);
+ final String avatarURL = commenter.optString(UserExt.USER_AVATAR);
+ comment.put(Comment.COMMENT_THUMBNAIL_URL, avatarURL);
+ }
+}
diff --git a/src/main/java/org/b3log/solo/service/CommentQueryService.java b/src/main/java/org/b3log/solo/service/CommentQueryService.java
new file mode 100644
index 00000000..766efc53
--- /dev/null
+++ b/src/main/java/org/b3log/solo/service/CommentQueryService.java
@@ -0,0 +1,265 @@
+/*
+ * Solo - A small and beautiful blogging system written in Java.
+ * Copyright (c) 2010-present, b3log.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see
+ * {
+ * "comments": [{
+ * "oId": "",
+ * "commentTitle": "",
+ * "commentName": "",
+ * "thumbnailUrl": "",
+ * "commentURL": "",
+ * "commentContent": "",
+ * "commentTime": long,
+ * "commentSharpURL": ""
+ * }, ....]
+ * "sc": "GET_COMMENTS_SUCC"
+ * }
+ *
+ * @throws ServiceException service exception
+ * @see Pagination
+ */
+ public JSONObject getComments(final JSONObject requestJSONObject) throws ServiceException {
+ try {
+ final JSONObject ret = new JSONObject();
+
+ final int currentPageNum = requestJSONObject.getInt(Pagination.PAGINATION_CURRENT_PAGE_NUM);
+ final int pageSize = requestJSONObject.getInt(Pagination.PAGINATION_PAGE_SIZE);
+ final int windowSize = requestJSONObject.getInt(Pagination.PAGINATION_WINDOW_SIZE);
+
+ final Query query = new Query().setPage(currentPageNum, pageSize).
+ addSort(Comment.COMMENT_CREATED, SortDirection.DESCENDING);
+ final JSONObject result = commentRepository.get(query);
+ final JSONArray comments = result.getJSONArray(Keys.RESULTS);
+
+ // Sets comment title and content escaping
+ for (int i = 0; i < comments.length(); i++) {
+ final JSONObject comment = comments.getJSONObject(i);
+ String title;
+
+ final String onId = comment.getString(Comment.COMMENT_ON_ID);
+ final JSONObject article = articleRepository.get(onId);
+ if (null == article) {
+ // 某种情况下导致的数据不一致：文章已经被删除了，但是评论还在
+ // 为了保持数据一致性，需要删除该条评论 https://hacpai.com/article/1556060195022
+ final Transaction transaction = commentRepository.beginTransaction();
+ final String commentId = comment.optString(Keys.OBJECT_ID);
+ commentRepository.remove(commentId);
+ transaction.commit();
+
+ continue;
+ }
+
+ title = article.getString(Article.ARTICLE_TITLE);
+ comment.put(Common.TYPE, Common.ARTICLE_COMMENT_TYPE);
+ comment.put(Common.COMMENT_TITLE, title);
+
+ String commentContent = comment.optString(Comment.COMMENT_CONTENT);
+ commentContent = Markdowns.toHTML(commentContent);
+ commentContent = Markdowns.clean(commentContent);
+ comment.put(Comment.COMMENT_CONTENT, commentContent);
+
+ String commentName = comment.optString(Comment.COMMENT_NAME);
+ commentName = Jsoup.clean(commentName, Whitelist.none());
+ comment.put(Comment.COMMENT_NAME, commentName);
+
+ comment.put(Comment.COMMENT_TIME, comment.optLong(Comment.COMMENT_CREATED));
+ comment.remove(Comment.COMMENT_CREATED);
+ }
+
+ final int pageCount = result.getJSONObject(Pagination.PAGINATION).getInt(Pagination.PAGINATION_PAGE_COUNT);
+ final JSONObject pagination = new JSONObject();
+ final List+ * Article ext properties: + *
+ * {
+ * ....,
+ * "authorName": "",
+ * "authorId": "",
+ * "authorThumbnailURL": "",
+ * "hasUpdated": boolean
+ * }
+ *
+ *
+ *
+ * @param context the specified HTTP servlet request context
+ * @param article the specified article
+ * @param preference the specified preference
+ * @throws ServiceException service exception
+ * @see #setArticlesExProperties(RequestContext, List, JSONObject)
+ */
+ private void setArticleExProperties(final RequestContext context, final JSONObject article, final JSONObject preference) throws ServiceException {
+ try {
+ final JSONObject author = articleQueryService.getAuthor(article);
+ final String authorName = author.getString(User.USER_NAME);
+ article.put(Common.AUTHOR_NAME, authorName);
+ final String authorId = author.getString(Keys.OBJECT_ID);
+ article.put(Common.AUTHOR_ID, authorId);
+ article.put(Article.ARTICLE_T_CREATE_DATE, new Date(article.optLong(Article.ARTICLE_CREATED)));
+ article.put(Article.ARTICLE_T_UPDATE_DATE, new Date(article.optLong(Article.ARTICLE_UPDATED)));
+
+ final String userAvatar = author.optString(UserExt.USER_AVATAR);
+ article.put(Common.AUTHOR_THUMBNAIL_URL, userAvatar);
+
+ if (preference.getBoolean(Option.ID_C_ENABLE_ARTICLE_UPDATE_HINT)) {
+ article.put(Common.HAS_UPDATED, articleQueryService.hasUpdated(article));
+ } else {
+ article.put(Common.HAS_UPDATED, false);
+ }
+
+ if (Solos.needViewPwd(context, article)) {
+ final String content = langPropsService.get("articleContentPwd");
+ article.put(ARTICLE_CONTENT, content);
+ }
+
+ processArticleAbstract(preference, article);
+
+ articleQueryService.markdown(article);
+
+ fillCategory(article);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, "Sets article extra properties failed", e);
+ throw new ServiceException(e);
+ }
+ }
+
+ /**
+ * Fills category for the specified article.
+ *
+ * @param article the specified article
+ */
+ public void fillCategory(final JSONObject article) {
+ final String tagsStr = article.optString(Article.ARTICLE_TAGS_REF);
+ final String[] tags = tagsStr.split(",");
+ JSONObject category = null;
+ for (final String tagTitle : tags) {
+ final JSONObject c = getCategoryOfTag(tagTitle);
+ if (null != c) {
+ category = c;
+ break;
+ }
+ }
+ article.put(Category.CATEGORY, category);
+ }
+
+ /**
+ * Gets a category for a tag specified by the given tag title.
+ *
+ * @param tagTitle the given tag title
+ * @return category, returns {@code null} if not found
+ */
+ private JSONObject getCategoryOfTag(final String tagTitle) {
+ try {
+ final JSONObject tag = tagRepository.getByTitle(tagTitle);
+ if (null == tag) {
+ return null;
+ }
+
+ final String tagId = tag.optString(Keys.OBJECT_ID);
+ final Query query = new Query().setFilter(new PropertyFilter(Tag.TAG + "_" + Keys.OBJECT_ID, FilterOperator.EQUAL, tagId)).
+ setPage(1, 1).setPageCount(1);
+ final JSONObject tagCategory = categoryTagRepository.getFirst(query);
+ if (null == tagCategory) {
+ return null;
+ }
+
+ final String categoryId = tagCategory.optString(Category.CATEGORY + "_" + Keys.OBJECT_ID);
+
+ return categoryRepository.get(categoryId);
+ } catch (final Exception e) {
+ LOGGER.log(Level.ERROR, "Gets category of tag [" + tagTitle + "] failed", e);
+
+ return null;
+ }
+ }
+
+ /**
+ * Sets some extra properties into the specified article with the specified preference.
+ * + * The batch version of method {@linkplain #setArticleExProperties(RequestContext, JSONObject, JSONObject)}. + *
+ *+ * Article ext properties: + *
+ * {
+ * ....,
+ * "authorName": "",
+ * "authorId": "",
+ * "hasUpdated": boolean
+ * }
+ *
+ *
+ *
+ * @param context the specified HTTP servlet request context
+ * @param articles the specified articles
+ * @param preference the specified preference
+ * @throws ServiceException service exception
+ */
+ public void setArticlesExProperties(final RequestContext context, final List-
+ *
- If the abstract is {@code null}, sets it with "" + *
- If user configured preference "titleOnly", sets the abstract with "" + *
- If user configured preference "titleAndContent", sets the abstract with the content of the article + *