Compare commits

..

No commits in common. "main" and "init-folder" have entirely different histories.

51 changed files with 89 additions and 1573 deletions

8
.idea/.gitignore vendored Normal file
View File

@ -0,0 +1,8 @@
# Default ignored files
/shelf/
/workspace.xml
# Datasource local storage ignored files
/../../../../../../:\WorkDir\GitHub\cwiki-us-docs\cwikius-docs\.idea/dataSources/
/dataSources.local.xml
# Editor-based HTTP Client requests
/httpRequests/

View File

@ -1,16 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="CheckStyle-IDEA" serialisationVersion="2">
<checkstyleVersion>10.17.0</checkstyleVersion>
<scanScope>JavaOnly</scanScope>
<copyLibs>true</copyLibs>
<option name="thirdPartyClasspath" />
<option name="activeLocationIds" />
<option name="locations">
<list>
<ConfigurationLocation id="bundled-sun-checks" type="BUNDLED" scope="All" description="Sun Checks">(bundled)</ConfigurationLocation>
<ConfigurationLocation id="bundled-google-checks" type="BUNDLED" scope="All" description="Google Checks">(bundled)</ConfigurationLocation>
</list>
</option>
</component>
</project>

View File

@ -0,0 +1,25 @@
<component name="ProjectCodeStyleConfiguration">
<code_scheme name="Project" version="173">
<JetCodeStyleSettings>
<option name="PACKAGES_TO_USE_STAR_IMPORTS">
<value>
<package name="java.util" alias="false" withSubpackages="false" />
<package name="kotlinx.android.synthetic" alias="false" withSubpackages="true" />
<package name="io.ktor" alias="false" withSubpackages="true" />
</value>
</option>
<option name="PACKAGES_IMPORT_LAYOUT">
<value>
<package name="" alias="false" withSubpackages="true" />
<package name="java" alias="false" withSubpackages="true" />
<package name="javax" alias="false" withSubpackages="true" />
<package name="kotlin" alias="false" withSubpackages="true" />
<package name="" alias="true" withSubpackages="true" />
</value>
</option>
</JetCodeStyleSettings>
<ScalaCodeStyleSettings>
<option name="MULTILINE_STRING_CLOSING_QUOTES_ON_NEW_LINE" value="true" />
</ScalaCodeStyleSettings>
</code_scheme>
</component>

View File

@ -0,0 +1,5 @@
<component name="ProjectCodeStyleConfiguration">
<state>
<option name="PREFERRED_PROJECT_CODE_STYLE" value="Default" />
</state>
</component>

2
CNAME
View File

@ -1 +1 @@
mumps.isharkfly.com
docs.ossez.com

View File

@ -1,37 +1,11 @@
# 联系方式
请使用下面的联系方式和我们联系:
| 联系方式名称 | 联系方式 |
|--------------------|-----------------------------------------------|
| 电子邮件 | [service@ossez.com](mailto:service@ossez.com) |
| QQ 或微信 | 103899765 |
| 社区论坛 (使用 mumps 标签) | https://www.isharkfly.com/tag/mumps |
# 公众平台
我们建议您通过社区论坛来和我们进行沟通,请关注我们公众平台上的账号。
扫描 QR 关注我们的微信公众号和头条号。
我们建议您通过社区论坛来和我们进行沟通,请关注我们公众平台上的账号
## 微信公众号
![](https://cdn.ossez.com/img/cwikius/cwikius-qr-wechat-search-w400.png)
## 头条号
我们也在头条号上创建了我们的公众号,请扫描下面的 QR 关注我们的头条号。
![](https://cdn.ossez.com/img/cwikius/cwikus-qr-toutiao.png)
## 知乎
请关注我们的知乎https://www.zhihu.com/people/huyuchengus
## 快速导航
在下面的表格中,我们列出了一些比较有用的 CWIKIUS 相关软件开发使用教程的导航,欢迎访问下面的链接获得更多的内容和参与讨论
| 网站名称 | URL | NOTE |
|--------------------|----------------------------------------------------------------|---------------------------|
| 鲨鱼君社区 | [www.isharkfly.com](https://www.isharkfly.com/) | 开放社区,欢迎注册参与讨论 |
| DOCS.ISHARKFLY.COM | [https://docs.isharkfly.com/#/](https://docs.isharkfly.com/#/) | 有关其他技术相关的文档和快速索引 |
| CN 博客 | [http://www.cwikius.cn/](http://www.cwikius.cn/) | CWIKIUS.CN 一个有独立思考和温度的清新站 |

21
LICENSE
View File

@ -1,21 +0,0 @@
MIT License
Copyright (c) 2022 ossez.com
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

View File

@ -1,34 +1,30 @@
# MUMPS 文档
# CWIKIUS 文档和手册
欢迎来到 MUMPS 文档和手册。
欢迎来到 CWIKIUS 文档和手册的空间
GitHub 上有关 HoneyMoose 的项目:[https://github.com/iSharkFly-Docs/mumps-docs](https://github.com/iSharkFly-Docs/mumps-docs)
GitHub 上有关 CWIKIUS 的项目:[https://github.com/cwiki-us-docs/cwikius-docs](https://github.com/cwiki-us-docs/cwikius-docs)
[联系我们](CONTACT.md ':include')
## 如何运行文档
本文档是通过 docsify 进行编译和安装的。
如果您有兴趣参与我们的小组和项目,请使用下面的联系方式和我们联系:
### 安装 docsify
如果你的计算机还没有安装 docsify 的话,请运行命令 `npm i docsify-cli -g` 来进行安装。
| 联系方式名称 | 联系方式 |
|---|---|
| 电子邮件 | [service@ossez.com](mailto:service@ossez.com) |
| QQ 或微信 | 103899765 |
| QQ 交流群 Spring | 15186112 |
| 社区论坛 | [https://www.ossez.com/](https://www.ossez.com/) |
### 校验安装结果
运行命令 `docsify -version` 来校验安装结果,界面上应该显示:
## 公众平台
我们建议您通过社区论坛来和我们进行沟通,请关注我们公众平台上的账号
```text
docsify-cli version:
4.4.3
```
### 微信公众号
![](https://cdn.ossez.com/img/cwikius/cwikius-qr-wechat-search-w400.png)
### 运行 docsify
如果你希望在你的本地计算机上查看本文档,请运行 `docsify serve ./` 在你的控制台上将会有下面的内如输出:
### 头条号
我们也在头条号上创建了我们的公众号,请扫描下面的 QR 关注我们的头条号。
```text
PS C:\WorkDir\Repository\Cwikius-Docs\cwikius-docs> docsify serve ./
![](https://cdn.ossez.com/img/cwikius/cwikus-qr-toutiao.png)
Serving C:\WorkDir\Repository\Cwikius-Docs\cwikius-docs now.
Listening at http://localhost:3000
```
## CWIKIUS 文档和手册快速导航
@ -36,30 +32,13 @@ Listening at http://localhost:3000
在这里对原作者表示感谢。
| 网站名称 | URL | NOTE | GitHuba Page 链接 |
|----------------|--------------------------------------------------------|---------------------------|----------------------------------------------------------------------------------------------------|
| DOCS.OSSEZ.COM | [https://docs.ossez.com/#/](https://docs.ossez.com/#/) | 本手册的编译版本将会部署在这个链接上 | [https://cwiki-us-docs.github.io/cwikius-docs/#/](https://cwiki-us-docs.github.io/cwikius-docs/#/) |
| WWW.CWIKIUS.CN | [http://www.cwikius.cn/](http://www.cwikius.cn/) | CWIKIUS.CN 一个有独立思考和温度的清新站 | N/A |
### 前端和 UI
| 网站名称 | URL | NOTE |
|-----------------|-----------------------------------------------------------------------------|-----------------------------|
| 前端技术社区 | https://www.ossez.com/c/toolkit-algorithm-computer-science/web-front-end/26 | 计算机相关的前端框架和讨论 |
| TypeScript 文档手册 | https://typescript.ossez.com/ | TypeScript 相关技术文档和手册 |
| Angular 技术手册 | https://angular.ossez.com/ | Angular 手册的在线翻译版本,从源代码中进行编译 |
| TypeScript 文档手册 | https://typescript.ossez.com/ | TypeScript 相关技术文档和手册 |
### 后端和数据层
| 网站名称 | URL | NOTE |
|------------------------|-------------------------------|----------------------|
| Apache Druid 技术手册 | https://druid.ossez.com/ | Druid 手册的在线翻译版本 |
| Amazon OpenSearch 技术手册 | https://opensearch.ossez.com/ | OpenSearch 手册的在线翻译版本 |
| 网站名称 | URL | NOTE |
|---|---|---|
| [github.io](https://cwiki-us-docs.github.io/cwikius-docs/#/) | [https://cwiki-us-docs.github.io/cwikius-docs/#/](https://cwiki-us-docs.github.io/cwikius-docs/#/) | 本手册的编译版本将会部署在这个链接上 |
| WWW.CWIKIUS.CN | [http://www.cwikius.cn/](http://www.cwikius.cn/) | CWIKIUS.CN 一个有独立思考和温度的清新站 |
### 容器 docker
| 网站名称 | URL | NOTE |
|--------------------|--------------------------------|-------------------------------------------------------------|
| Docker 手册中译在线版 | https://docker.ossez.com/ | 基于 Docker 容器英文手册的翻译版本 |
| Docker 手册中译 MD 在线版 | https://docker-docs.ossez.com/ | 因为 Docker 的官方手册进行了渲染,我们推荐你使用上面的链接,这个版本为 docsify 渲染版本,可能会丢格式 |
| 网站名称 | URL | NOTE |
|---|---|---|
| Docker 手册中译在线版 | https://docker.ossez.com/ | 基于 Docker 容器英文手册的翻译版本|
| Docker 手册中译 MD 在线版 | https://docker-docs.ossez.com/ | 因为 Docker 的官方手册进行了渲染,我们推荐你使用上面的链接,这个版本为 docsify 渲染版本,可能会丢格式 |

View File

@ -1,96 +0,0 @@
# M[UMPS] 参考 (Reference)
M 语言的参考很乱,到目前为止也没有找到非常多的有效文件。
在这个页面中,我们对网络上能收集到的文档和资料进行归档,以便于大家快速下载。
# M Programming Language
MUMPS (M) is a high performance transaction processing keyvalue database with integrated programming language.
__M history__
https://en.wikipedia.org/wiki/MUMPS
M syntax
https://en.wikipedia.org/wiki/MUMPS_syntax
M standard
http://71.174.62.16/Demo/AnnoStd
M language guide
https://www.cs.uni.edu/~okane/source/MUMPS-MDH/MumpsUsersGuide.pdf
https://www.cs.uni.edu/~okane/source/MUMPS-MDH/MumpsTutorial.pdf
M language forum
https://groups.google.com/g/comp.lang.mumps
M pocket guide
http://vistaexpertise.net/bookstore/1995-standard-mumps-pocket-guide/1995-standard-mumps-pocket-guide.pdf
M example code
https://github.com/programarivm/mumps-examples
http://71.174.62.16/Demo/AnnoStd?Frame=Main&Page=a100006
M books
https://www.amazon.com/Mumps-Programming-Language-Kevin-OKane-ebook/dp/B00MZIMA1M
M training
https://www.pioneerdatasys.com/site/train/m2s.html
M utilities
https://www.hardhats.org/tools/MUtilframe.html
M blogs
https://www.datasciencecentral.com/mumps-the-most-important-database-you-probably-never-heard-of
https://www.elys.com/blog/mumps-the-arcane-database-language-behind-our-electronic-medical-records
M: Vista Programming
https://www.hardhats.org/tools/vpe/vpe_db.html
http://www.vistapedia.net/index.php/MUMPS_Overview
http://www.vistapedia.net/index.php/Introduction_To_Programming_VistA_with_MUMPS
http://www.vistapedia.net/index.php/VistA_Database_Globals
http://www.vistapedia.net/index.php/Object_Oriented_Programming_with_M
## M implementations
__Reference standard mumps (RSM)__
https://gitlab.com/Reference-Standard-M/rsm
__YottaDB__
https://gitlab.com/YottaDB
https://yottadb.com/product/get-started/
https://docs.yottadb.com/ProgrammersGuide/devcycle.html#overview-of-the-program-development-cycle
https://yottadb.com/connect-microsoft-analytics-and-business-intelligence-tools-to-octo/
### JSR
https://mumps-dev.github.io/jsr/
### MUMPS Tutorials
[Mumps 语言有关多层次和维度的程序员工具包指南(The Multi-Dimensional and Hierarchical Database Toolkit Programmers Guide)](https://www.isharkfly.com/t/the-multi-dimensional-and-hierarchical-database-toolkit-programmers-guide/16033)
[Mumps 语言快速基本概述(A Quick Overview of the Basics of the Mumps Language)](https://www.isharkfly.com/t/mumps/16037)
[Mumps 程序语言解释器编译器和 C++ 类库用户指南](https://www.isharkfly.com/t/mumps-c/16038)
[Mumps 语言标准指南 - 1995 年版](https://www.isharkfly.com/t/mumps-1995/16039)
[Mumps 语言开发标准 2020 年草案](https://www.isharkfly.com/t/mumps-2020/16040)
https://www.cs.uni.edu/~okane/index.html
https://www.cs.uni.edu/~okane/mumps.html
https://www.cs.uni.edu/~okane/youtube.html#mumps
https://youtube.com/playlist?list=PLmMgHNtOIstYpwQRy5btu-P-Gl90IsjPM
### Hacker News
Introduction to the Mumps Language
https://news.ycombinator.com/item?id=16309237
https://news.ycombinator.com/item?id=13859961
### Daily WTF
https://thedailywtf.com/articles/MUMPS-Madness
https://thedailywtf.com/articles/A_Case_of_the_MUMPS
https://robtweed.wordpress.com/2012/10/21/a-case-of-the-mumps/
### M Developer gits
https://github.com/robtweed

View File

@ -1,25 +1,12 @@
- MUMPS 文档概述
- CWIKIUS 文档概述
- [文档介绍和快速链接](README.md)
- [联系方式](CONTACT.md)
- [联系方式](CONTACT.md)
- [公众平台](CONTACT.md)
- 语言参考
- [概述和环境配置](java/_README.md)
- [核心编程](java/core/_README.md)
- [语言基础](java/fundamentals/_README.md)
- Gradle
- [Deploy](deploy.md)
- 示例代码
- [Spring](framework/spring/_README.md)
- [核心编程](java/core/_README.md)
- [语言基础](java/fundamentals/_README.md)
-
- 其他小工具
- [JWT](jwt/README.md)
- [MessagePack](message-pack/index.md)
- [Protocol Buffers](protocol-buffers/index.md)
- 导航和参考
- [REF](REFERENCE.md)
- [WWW.ISHARKFLY.COM](https://www.isharkfly.com/tag/mumps)
- [MUMPS.ISHARKFLY.COM](https://mumps.isharkfly.com/#/)
- [Awesome docsify](awesome.md)
- [Changelog](changelog.md)

View File

@ -1,19 +0,0 @@
# 算法
在应聘技术岗位的时候,可能都会有一个让绝大部分人都比较讨厌的算法环节。
也不知道是谁搞出这么无聊的东西,但没有办法现实总是残酷的,在抱怨的同时也只能在找工作之前复习下这些在实际工作中基本上不用的算法题了。
因为 MD 文档格式的限制,所以我们在这里只放一个索引并且维护这个索引,有关的具体内容,请通过索引访问我们的社区进行查看,我们也非常欢迎您参与讨论,
您可以在社区注册后进行讨论。
## 算法问题
在这里我将按照我遇到算法问题的先后顺序进行排列。很多算法题目都是题库上面的原题,你可以到题库上面去找找。
我这里只是结合我在面试的时候遇到的题目来进行解答和进行一些点评,就当时总结和消遣吧,如果你希望有什么问题一起讨论的话,欢迎 Fork 这个项目并且登录社区进行讨论。
最新的内容在最前面。
### 内容索引
* [A “word-wrap” functionality一个字符串包裹函数](https://www.ossez.com/t/a-word-wrap-functionality/13452)
* [Prime numbers from 1 to 100 (打印 100 以内的素数)](https://www.ossez.com/t/prime-numbers-from-1-to-100-100/13450)

View File

@ -1,197 +0,0 @@
# Discourse 文档
Discourse 文档是通过官方文档的整理翻译过来的,下面的内容与官方的内容基本一致。
针对中文环境下的时候,我们对遇到的一些问题发布到我们的讨论区中以方便大家快速导航访问:
- [Discourse CentOS 8 全新安装手册](https://www.ossez.com/t/discourse-centos-8/594) - 在 CentOS/RHEL 平台上全新安装 Discourse 的过程和命令。
- [Discourse 如何不使用 Lets Encrypt 而使用 CA 签名的密钥进行安装](https://www.ossez.com/t/discourse-lets-encrypt-ca/552) - 使用你自己已有的 CA 秘钥进行安装。
- [Discourse 设置 GTM](https://www.ossez.com/t/discourse-gtm/13240) - 使用 Google 的标签管理器来插入需要的 JS 代码。
## 云平台安装
**在基于云平台的 Discourse 安装通常不会超过 30 分钟**,哪怕你没有任何有关 Rails 或 Linux shell 的知识都能够顺利完成安装。
下面我们是通过 [DigitalOcean][do] 服务提供商来进行安装测的,但是所有的安装步骤都能够在
所有兼容 **Docker** 的云计算平台上进行,同时也可以在本地的服务器上完成安装。
> 🔔 如果你连 30 分钟都没有的话?你可以联系 Discourse 社区来帮你完成安装Discourse 社区将会收取一次性 $150 (美元)的费用。 [单击此处链接来对服务进行购买](https://www.literatecomputing.com/product/discourse-install/) 。
### 创建一个新的云服务器
创建一个你的新云服务器,例如:[DigitalOcean](https://www.digitalocean.com/?refcode=5fa48ac82415) ,当然你也可以使用其他平台提供的服务器。
- 默认配置 **当前版本的 LTS Ubuntu 操作系统** 能够很好的工作。最少,需要一个 64 位的 Linux 操作系统,并且这个操作系统的内核需要更新到最新的版本。
- 默认配置 **1 GB** 的内存针对小型的 Discourse 社区通常都能很好的运行。但我们推荐针对大型社区使用 2 GB 的内存。
- 默认配置 **New York** 数据中心针对北美和欧洲来说都是不错的地理分区,如果你的 Discourse 用户使用的对象多是其他地理位置的用户,那么你可以选择离你稍近的数据中心。
- 输入域名 `discourse.example.com` 来在 DigitalOcean 中创建一个 DropletDroplet 是 DigitalOcean 定义的服务器名称)。当然你也可以购买使用你自己的域名,通常 Discourse 的安装需要一个真实的域名,没有办法通过 IP 地址安装,所以我们建议你首先购买域名或者使用你已有域名的二级域名。
创建你的新 Droplet这个过程就等于你在 DigitalOcean 上创建了一个服务器,也等同你在其他平台上面创建了一个 VPS 或者服务器。
当完成创建后,你将会收到一个电子邮件,这个电子邮件中有你的 Root 用户的密码。
但是我们建议你 [设置使用 SSH keys](https://www.google.com/search?q=digitalocean+ssh+keys) 来增强你服务器访问的安全性。
### 访问你的云服务器
通过使用 IP 地址,并使用 SSH 来连接和访问你创建的服务器,或者针对 Windows 平台你可以安装 [Putty][put] 后运行下面的命令来进行连接:
ssh root@192.168.1.1
如果你没有配置 SSH Key 的话,你可以使用 DigitalOcean 发给你的电子邮件中包含的密码来进行登录,
或者使用你本地的 SSH Key 来进行连接。
### 安装 Docker / Git (可选的)
如果你希望使用你自己的 Docker 版本,你可以现在在你新设置的服务器上进行安装。
如果你的服务器上没有默认安装 Docker那么 `discourse-setup` 将会自动为你从 get.docker.com 下载后进行安装。
### 安装 Discourse
从 [官方 Discourse Docker 镜像][dd] 仓库中克隆代码到本地计算机的 `/var/discourse` 目录。
sudo -s
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse
你只需要执行上面的命令即可,在 Discourse 安装的过程中需要 root 权限。
### 电子邮件
> ⚠️ **电子邮件系统在 Discourse 的用户创建过程中非常重要。**
> 如果你没有在安装 Discourse 之前创建电子邮件 SMTP 服务器,那么你安装的 Discourse 无法访问也无法登录HAVE A BROKEN SITE
- 如果你已经有你自己的 SMTP 邮件服务器了,那么你就可以直接使用你已有的邮件服务器配置信息。
- 还有没有邮件服务器?请访问 [**Discourse 推荐使用的邮件服务器**][mailconfig].
- 为了确保你的邮件能够被正常投递,你必须在你的 DNS 中添加有效的 [SPF 和 DKIM 记录](https://www.google.com/search?q=spf+dkim) 。请访问你邮件服务提供商的文档如何设置这些信息。
根据我们实际使用的情况Discourse 的安装**必须**配置可用的域名和邮件服务器,针对中国境内的情况,你可以使用阿里云或者腾讯云提供的企业邮箱。
通常我们建议你使用境外的邮件服务器,比如说 AWS 的 SES或者 MailGun 都是不错的服务,你可能需要一张国际信用卡完成校验。
但这一步是必须的,否则你的的 Discourse 无法完成安装。
### 域名
> 🔔 Discourse 不能通过 IP 地址来工作,你必须拥有一个域名或者二级域名来进行安装,例如 `example.com`
- 如果你已经拥有一个域名了,那么可以选择任何一个二级域名来进行安装,例如 `discourse.example.com``talk.example.com``forum.example.com` 来安装你的 Discourse 实例。
- 还没有域名的话,你可以访问 [NameCheap](https://www.namecheap.com/domains/domain-name-search/) 网站来搜索你喜欢的域名,或者直接 Google 搜索 [great domain name registrars](https://www.google.com/search?q=best+domain+name+registrars) 来选择你喜欢的域名注册商。
- 你的 DNS 控制台应该是能够访问的,在你购买域名后,你还需要访问你的 DNS 配置来配置 DNS。针对你安装的 Discourse 网站,你需要通过你的 DNS 创建一个 [`A` 记录](https://support.dnsimple.com/articles/a-record/) ,这个 A 记录需要将你要安装的域名指向到一个特定的 IP 地址。这个 IP 地址通常为你在第一步购买的服务器 IP 地址。
### 编辑 Discourse 配置
通过下面的命令运行配置工具
./discourse-setup
你需要根据下面的提示配置所有参数:
Hostname for your Discourse? [discourse.example.com]:
Email address for admin account(s)? [me@example.com,you@example.com]:
SMTP server address? [smtp.example.com]:
SMTP port? [587]:
SMTP user name? [user@example.com]:
SMTP password? [pa$$word]:
Let's Encrypt account email? (ENTER to skip) [me@example.com]:
上面的输入数据将会为你的 Discourse 实例创建一个 `app.yml` 文件,这个文件将会在安装进行后对你的 Discourse 实例进行配置。
整个安装启动过程可能需要耗费 **2-8 分钟** 来为你的配置 Discourse。
如果在安装完成后你还需要对你的配置进行修改,你可以再次运行 `./discourse-setup` 命令(这个命令将会把已经存在的 `app.yml` 文件重新载入)。
或者你也可以手动直接编辑 `/containers/app.yml` 文件中的内容,然后再次运行 `./launcher rebuild app`,否则你的修改是不会生效的。
### 启动 Discourse
一旦初始化安装配置完成后,你的 Discourse 示例应该可以通过你配置的域名 `discourse.example.com` 在浏览器上进行访问。
<img src="https://cdn.ossez.com/discourse-uploads/optimized/2X/8/8db53b9128ec4fb74872bdb7c1231ff04d525218_2_616x500.png" width="650">
### 注册一个新的管理员账号
使用你再启动配置过程中输入的电子邮件地址来注册一个管理员账号。
<img src="https://cdn.ossez.com/discourse-uploads/original/2X/9/99476eac0ffa4aa3a923aa7ae864fedf546dab0a.png" width="650">
<img src="https://cdn.ossez.com/discourse-uploads/original/2X/5/58660d377a00d9797be8b74036ace9d0ebf57fff.png" width="650">
(如果你不能注册你的管理账号Admin请通过路径`/var/discourse/shared/standalone/log/rails/production.log` 检查日志,或者访问 [电子邮件问题检查列表](https://meta.discourse.org/t/troubleshooting-email-on-a-new-discourse-install/16326) 。)
当你完成管理员账号的注册后,设置向导将会启动并指引你配置你的 Discourse 实例。
<img src="https://cdn.ossez.com/discourse-uploads/original/2X/9/944509dd0c049a2cec42d6108369fa5cf5d92d0d.png" width="650">
当完成所有的设置向导你将会看到职员主题Staff topics**READ ME FIRST: Admin Quick Start Guide**
这个配置向导将会包含有针对后续配置的的一些建议和如何对你的 Discourse 安装实例进行自定义配置。
<img src="https://cdn.ossez.com/discourse-uploads/original/2X/8/8a60bc840705aaa1fc77b039a7babf77d6b4a10b.png" width="650">
### 安装后的维护
- 我们强烈建议打开你针对你操作系统的安全自动更新。在 Ubuntu 使用 `dpkg-reconfigure -plow unattended-upgrades` 命令。在 CentOS/RHEL使用 [`yum-cron`](https://www.cyberciti.biz/faq/fedora-automatic-update-retrieval-installation-with-cron/) 包。
- 如果你使用的是密码登录你的操作系统,而不是使用 SSH Key 的话,请确保你使用强密码。在 Ubuntu 使用 `apt-get install libpam-cracklib` 包。我们推荐使用 `fail2ban` ,这个将会对 3 次登录失败的 IP 地址禁止登录 10 分钟。
- **Ubuntu**: `apt-get install fail2ban`
- **CentOS/RHEL**: `sudo yum install fail2ban` (需要 [EPEL](https://support.rackspace.com/how-to/install-epel-and-additional-repositories-on-centos-and-red-hat/))
- 如果你希望默认安装防火墙, 针对 Ubuntu [打开 ufw](https://meta.discourse.org/t/configure-a-firewall-for-discourse/20584) 或者针对 CentOS/RHEL 7 及其后续版本使用 `firewalld`
当 Discourse 有新版本更新的时候,你的邮件地址将会收到更新提示。
请随时更新你的 Discourse 实例到最新版本以确保所有的安全问题被修复。
**更新 Discourse 到最新的版本**,请通过你的浏览器访问 `/admin/upgrade` 然后单击更新按钮。
`/var/discourse` 目录中的 `launcher` 命令被用来使用一些系统级别的维护:
``` text
Usage: launcher COMMAND CONFIG [--skip-prereqs] [--docker-args STRING]
Commands:
start: Start/initialize a container启动/初始化容器)
stop: Stop a running container停止一个运行的容器
restart: Restart a container重启容器
destroy: Stop and remove a container (停止然后删除一个容器)
enter: Use nsenter to get a shell into a container (使用 nsenter 来访问容器内的 Shell
logs: View the Docker logs for a container查看一个容器的日志
bootstrap: Bootstrap a container for the config based on a template从配置模板中来启动一个容器的配置和初始化
rebuild: Rebuild a container (destroy old, bootstrap, start new)(重构一个容器,将会删除老的容器,初始一个容器,启动新的容器)
cleanup: Remove all containers that have stopped for > 24 hours针对停止运行超过 24 个小时的容器进行删除)
Options:
--skip-prereqs Don't check launcher prerequisites (不运行安装器的环境校验)
--docker-args Extra arguments to pass when running docker (传递给容器内的额外参数)
```
### 添加更多的 Discourse 特性
下面的内容是一些快速的链接,能够帮助你扩展 Discourse 安装的功能:
- Users to log in *only* via your pre-existing website's registration system? [Configure Single-Sign-On](https://meta.discourse.org/t/official-single-sign-on-for-discourse/13045).
- 用户可以使用 [Google](https://www.ossez.com/t/discourse-google-google-login/13582), [Twitter](https://meta.discourse.org/t/configuring-twitter-login-for-discourse/13395), [GitHub](https://www.ossez.com/t/discourse-github/13562), or [Facebook](https://meta.discourse.org/t/configuring-facebook-login-for-discourse/13394) 进行注册登录。
- Users to post replies via email? [Configure reply via email](https://meta.discourse.org/t/set-up-reply-via-email-support/14003).
- Automatic daily backups? [Configure backups](https://meta.discourse.org/t/configure-automatic-backups-for-discourse/14855).
- Free HTTPS / SSL support? [Configure Let's Encrypt](https://meta.discourse.org/t/setting-up-lets-encrypt-cert-with-discourse-docker/40709). Paid HTTPS / SSL support? [Configure SSL](https://meta.discourse.org/t/allowing-ssl-for-your-discourse-docker-setup/13847).
- Use a plugin [from Discourse](https://github.com/discourse) or a third party? [Configure plugins](https://meta.discourse.org/t/install-a-plugin/19157)
- Multiple Discourse sites on the same server? [Configure multisite](https://meta.discourse.org/t/multisite-configuration-with-docker/14084).
- Webhooks when events happen in Discourse? [Configure webhooks](https://meta.discourse.org/t/setting-up-webhooks/49045).
- A Content Delivery Network to speed up worldwide access? [Configure a CDN](https://meta.discourse.org/t/enable-a-cdn-for-your-discourse/14857). We recommend [Fastly](http://www.fastly.com/).
- Import old content from vBulletin, PHPbb, Vanilla, Drupal, BBPress, etc? [See our open source importers](https://github.com/discourse/discourse/tree/main/script/import_scripts).
- A user friendly [offline page when rebuilding or upgrading?](https://meta.discourse.org/t/adding-an-offline-page-when-rebuilding/45238)
- To embed Discourse [in your WordPress install](https://github.com/discourse/wp-discourse), or [on your static HTML site](https://meta.discourse.org/t/embedding-discourse-comments-via-javascript/31963)?
Help us improve this guide! Feel free to ask about it on [meta.discourse.org][meta], or even better, submit a pull request.
[dd]: https://github.com/discourse/discourse_docker
[ssh]: https://help.github.com/articles/generating-ssh-keys
[meta]: https://meta.discourse.org
[do]: https://www.digitalocean.com/?refcode=5fa48ac82415
[put]: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
[mailconfig]: https://github.com/discourse/discourse/blob/main/docs/INSTALL-email.md

View File

@ -1,13 +0,0 @@
{
"database": {
"rules": "database.rules.json"
},
"hosting": {
"public": "./",
"ignore": [
"firebase.json",
"**/.*",
"**/node_modules/**"
]
}
}

View File

@ -1,5 +0,0 @@
# Spring 框架
[](spring-boot-testing.md ':include')
[](spring-di.md ':include')

View File

@ -1,12 +0,0 @@
## Spring Boot 测试
本模块中包含了有关如何在 Spring Boot 中进行测试和在测试中遇到的一些问题和解决的文章。
- [Testing with Spring and Spock](https://www.baeldung.com/spring-spock-testing)
- [Exclude Auto-Configuration Classes in Spring Boot Tests](https://www.baeldung.com/spring-boot-exclude-auto-configuration-test)
- [Embedded Redis Server with Spring Boot Test](https://www.baeldung.com/spring-embedded-redis)
- [Testing Spring Boot @ConfigurationProperties](https://www.baeldung.com/spring-boot-testing-configurationproperties)
- [Prevent ApplicationRunner or CommandLineRunner Beans From Executing During Junit Testing](https://www.baeldung.com/spring-junit-prevent-runner-beans-testing-execution)
- [Testing in Spring Boot](https://www.baeldung.com/spring-boot-testing)
- [解决在 Spring Boot 中运行 JUnit 测试遇到的 NoSuchMethodError 错误](https://www.ossez.com/t/spring-boot-junit-nosuchmethoderror/14066)
- More articles: [[more -->]](../spring-boot-testing-2)

View File

@ -1,12 +0,0 @@
## Spring 依赖注入Dependency Injection
本模块中包含了有关如何在 Spring 的依赖注入Dependency Injection的相关问题进行讨论。
- [The Spring @Qualifier Annotation](https://www.baeldung.com/spring-qualifier-annotation)
- [Spring Autowiring of Generic Types](https://www.baeldung.com/spring-autowire-generics)
- [Guice vs Spring Dependency Injection](https://www.baeldung.com/guice-spring-dependency-injection)
- [Injecting Prototype Beans into a Singleton Instance in Spring](https://www.baeldung.com/spring-inject-prototype-bean-into-singleton)
- [Controlling Bean Creation Order with @DependsOn Annotation](https://www.baeldung.com/spring-depends-on)
- [Unsatisfied Dependency in Spring](https://www.baeldung.com/spring-unsatisfied-dependency)
- [XML-Based Injection in Spring](https://www.baeldung.com/spring-xml-injection)
- More articles: [[next -->]](../spring-di-2)

BIN
gradle/wrapper/gradle-wrapper.jar vendored Normal file

Binary file not shown.

View File

@ -0,0 +1,5 @@
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-5.4-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

View File

@ -11,33 +11,19 @@
})(window,document,'script','dataLayer','GTM-W3NL9V');</script>
<!-- End Google Tag Manager -->
<title>MUMPS 文档手册</title>
<title>CWIKIUS 文档手册</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>
<meta name="description" content="Description">
<meta name="viewport"
content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify-themeable@0/dist/css/theme-simple.css">
<style>
:root {
/* Reduce the font size */
/* --base-font-size: 14px; */
/* Change the theme color hue (0-360) */
/* --theme-hue: 325; */
/* Add sidebar navigation bullets */
/* --sidebar-nav-link-before-content-l1: "😀"; */
/* --sidebar-nav-link-before-content-l2: "💩"; */
--link-color: var(--theme-color);
}
</style>
<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/lib/themes/vue.css">
</head>
<body>
<div id="app"></div>
<script>
window.$docsify = {
name: 'MUMPS 文档手册',
repo: 'https://github.com/iSharkFly-Docs/mumps-docs.git',
name: 'CWIKIUS 文档手册',
repo: 'https://github.com/cwiki-us-docs/cwikius-docs',
executeScript: true,
loadNavbar: true,
mergeNavbar: true,

Binary file not shown.

Before

Width:  |  Height:  |  Size: 9.9 KiB

View File

@ -1,51 +0,0 @@
# 面试问题和经验文档
在应聘技术岗位的时候,通常会要求你进行一些算法和基础知识的考核。因计算机的知识比较复杂概念也非常多,这就给应聘者带来很大的困惑,应该怎么去做?
同时面试官很多时候也是突击某个问题,然后拿着这个问题来问应聘者。结果就导致了很多问题非常刁钻古怪,甚至有时候你根本就不可能在实际开发中遇到。
不管怎么样,这种面试方式至少目前来说是一种趋势,所以我们尽量收集一些技术岗的面试经验供大家参考。
![it-job-interview](_images/it-job-interview.jpg)
因为 MD 文档格式的限制,所以我们在这里只放一个索引并且维护这个索引,有关的具体内容,请通过索引访问我们的社区进行查看,我们也非常欢迎您参与讨论,
您可以在社区注册后进行讨论。
## CS 基础
如果你有比较好的 CS 基础,那么下面的内容肯对你来说可能就太基础了。
如果你没有 CS 基础,但是想转成 CS 并且需要进行一些面试下面的这些内容也许能帮你想想盒子外面有什么Thinking outside the
box顺便能够过一下 CS 的原理和概念。
* [为什么要转码](https://www.isharkfly.com/t/topic/13891)
*
## 面试问题和经验索引
在这里我们希望按照年份进行一些分开,这样能够帮助大家尽量区分时间,同时我们的排序是按照倒序排列的。
最新的内容在最前面(按照时间倒序排序)。
### 2023
* [题目有点太简单了,不知道怎么选了](https://www.isharkfly.com/t/topic/14588)
* [Java 乘等赋值运算](https://www.isharkfly.com/t/java/14590)
* [如何用 Java 找到字符串中的元音](https://www.isharkfly.com/t/java/14841)
### 2021
* [一次谈不上有点内卷的美东某金融公司面试](https://www.isharkfly.com/t/topic/13820)
* [美东某 IoT 公司技术流程第一轮沟通就挂了](https://www.isharkfly.com/t/iot/13815)
* [2021 年美东地区 IoT 公司的一次失败面试](https://www.isharkfly.com/t/2021-iot/13791)
* [2021 年一次比较奇葩的 AWS 面试](https://www.isharkfly.com/t/2021-aws/13788)
* [2021 疫情期间美国公司技术岗的面试流程](https://www.isharkfly.com/t/topic/13463)
* [从拒绝到被拒绝](https://www.isharkfly.com/t/topic/13462)
* [从一个工作到一个工作](https://www.isharkfly.com/t/topic/13461)
* [北美亚特兰大一金融服务公司面试总结](https://www.isharkfly.com/t/topic/13453)
* [北美一工作搜索引擎公司技术岗面经](https://www.isharkfly.com/t/topic/13451)
* [一房地产数据服务初创公司的面经](https://www.isharkfly.com/t/topic/13441)
### 2019
* [IT 技术岗位 2019 年北美求职流水账](https://www.isharkfly.com/t/it-2019/13433)

View File

@ -1,18 +0,0 @@
## Java 技术问题导航
Java 是由 Sun Microsystems 公司于 1995年5月推出的 Java 面向对象程序设计语言和 Java 平台的总称Java 1.0 [J2SE])。
由 James Gosling和同事们共同研发并在 1995 年正式推出。
由于 Sun 在早年被 Oracle 公司收购了,目前 Java 是 Oracle 公司的资产和注册商标。
本页面中主要对 Java 使用的基础知识和配置的内容进行快速导航。
Java 的配置比较复杂,同时还有比较复杂的编译和集成工具,因此必要对 Java 使用的环境进行一些说明,来帮助大家快速了解和使用这么语言。
### 安装
任何语言或者程序在使用之前都需要先配置环境,在这个页面我们主要对 Java 环境配置的内容进行总结。
- [Windows 环境下安装 Oracle JDK](https://www.ossez.com/t/windows-oracle-jdk/7254)
## 配置环境
* [Java 在 Windows 10 中配置环境变量](https://www.ossez.com/t/java-windows-10/13675)

View File

@ -1,2 +0,0 @@
# 集合

View File

@ -1,11 +0,0 @@
# Java 核心编程
[](core-java-8.md ':include')
[](core-java-11.md ':include')
[](core-java-annotations.md ':include')
[](core-java-numbers.md ':include')
[](core-java-strings.md ':include')

View File

@ -1,21 +0,0 @@
## Java 11 核心
本模块中包含有关 Java 11 核心新增功能特性的一些文章。
- [Java 11 Single File Source Code](https://www.baeldung.com/java-single-file-source-codehttps://www.baeldung.com/java-single-file-source-code)
- [Java 11 Local Variable Syntax for Lambda Parameters](https://www.baeldung.com/java-var-lambda-params)
- [Java 11 String API Additions](https://www.baeldung.com/java-11-string-api)
- [Java 11 Nest Based Access Control](https://www.baeldung.com/java-nest-based-access-control)
- [Exploring the New HTTP Client in Java](https://www.baeldung.com/java-9-http-client)
- [An Introduction to Epsilon GC: A No-Op Experimental Garbage Collector](https://www.baeldung.com/jvm-epsilon-gc-garbage-collector)
- [Guide to jlink](https://www.baeldung.com/jlink)
- [Negate a Predicate Method Reference with Java 11](https://www.baeldung.com/java-negate-predicate-method-reference)
- [Benchmark JDK Collections vs Eclipse Collections](https://www.baeldung.com/jdk-collections-vs-eclipse-collections)
- [Pre-compile Regex Patterns Into Pattern Objects](https://www.baeldung.com/java-regex-pre-compile)
- [Guide to Java Reflection](http://www.baeldung.com/java-reflection)
- [Guide to Java 8s Collectors](https://www.baeldung.com/java-8-collectors)
- [New Features in Java 11](https://www.baeldung.com/java-11-new-features)
- [Getting the Java Version at Runtime](https://www.baeldung.com/get-java-version-runtime)
- [Invoking a SOAP Web Service in Java](https://www.baeldung.com/java-soap-web-service)
- [Java HTTPS Client Certificate Authentication](https://www.baeldung.com/java-https-client-certificate-authentication)
- [Call Methods at Runtime Using Java Reflection](https://www.baeldung.com/java-method-reflection)

View File

@ -1,20 +0,0 @@
## Java 8 核心
本模块中包含有关 Java 8 核心新增功能特性的一些文章。
- [New Features in Java 8](https://www.baeldung.com/java-8-new-features)
- [Guide to Java 8 groupingBy Collector](https://www.baeldung.com/java-groupingby-collector)
- [Java 8 中的设计模式策略](https://www.ossez.com/t/java-8/13978)
- [Guide to Java 8 Comparator.comparing()](https://www.baeldung.com/java-8-comparator-comparing)
- [Guide to the Java 8 forEach](https://www.baeldung.com/foreach-java)
- [Introduction to Spliterator in Java](https://www.baeldung.com/java-spliterator)
- [Finding Min/Max in an Array with Java](https://www.baeldung.com/java-array-min-max)
- [Internationalization and Localization in Java 8](https://www.baeldung.com/java-8-localization)
- [Generalized Target-Type Inference in Java](https://www.baeldung.com/java-generalized-target-type-inference)
- [Run a Java Application from the Command Line](https://www.baeldung.com/java-run-jar-with-arguments)
- [Java 8 Stream skip() vs limit()](https://www.baeldung.com/java-stream-skip-vs-limit)
- [Guide to Java BiFunction Interface](https://www.baeldung.com/java-bifunction-interface)
- [Interface With Default Methods vs Abstract Class](https://www.baeldung.com/java-interface-default-method-vs-abstract-class)
- [Convert Between Byte Array and UUID in Java](https://www.baeldung.com/java-byte-array-to-uuid)
- [Create a Simple “Rock-Paper-Scissors” Game in Java](https://www.baeldung.com/java-rock-paper-scissors)
- [Java 8 开始新增的 Optional 类](https://www.ossez.com/t/java-8-optional/13964)

View File

@ -1,11 +0,0 @@
## Annotation注解
Java 注解Annotation又称 Java 标注,是 JDK5.0 引入的一种注释机制。
Java 语言中的类、方法、变量、参数和包等都可以被标注。和 Javadoc 不同Java 标注可以通过反射获取标注内容。在编译器生成类文件时标注可以被嵌入到字节码中。Java 虚拟机可以保留标注内容,在运行时可以获取到标注内容 。 当然它也支持自定义 Java 标注。
- [Java @Override Annotation](https://www.baeldung.com/java-override)
- [Java @SuppressWarnings Annotation](https://www.baeldung.com/java-suppresswarnings)
- [Java @SafeVarargs Annotation](https://www.baeldung.com/java-safevarargs)
- [Java @Deprecated Annotation注解](https://www.ossez.com/t/java-deprecated-annotation/13676)
- [Overview of Java Built-in Annotations](https://www.baeldung.com/java-default-annotations)
- [Creating a Custom Annotation in Java](https://www.baeldung.com/java-custom-annotation)

View File

@ -1,6 +0,0 @@
## Java 数字Number
本模块中包含有关 Java 数字Number有关的文章。
- [理解 Java 中的 NumberFormatException 异常](https://www.ossez.com/t/java-numberformatexception/13986)
-

View File

@ -1,16 +0,0 @@
## Java 字符串Strings
本模块中包含有关 Java 字符串String有关的文章。
- [Java 使用 char[] Array 还是 String 存储字符串密码](https://www.ossez.com/t/java-char-array-string/14015)
- [Java 9 中的字符串String压缩](https://www.ossez.com/t/java-9-string/14024)
- [String Not Empty Test Assertions in Java](https://www.baeldung.com/java-assert-string-not-empty)
- [String Performance Hints](https://www.baeldung.com/java-string-performance)
- [Java Localization Formatting Messages](https://www.baeldung.com/java-localization-messages-formatting)
- [Java Generate Random String](https://www.baeldung.com/java-random-string)
- [Java String Interview Questions and Answers](https://www.baeldung.com/java-string-interview-questions)
- [Java 多行字符串](https://www.ossez.com/t/java/14049)
- [Java 中的 String Pool 简介](https://www.ossez.com/t/java-string-pool/14017)
- [Java “constant string too long” 编译错误](https://www.ossez.com/t/java-constant-string-too-long/14048)
- [Java 对象如何安全的 toString](https://www.ossez.com/t/java-tostring/14000)
- [编程常用的几种字符编码](https://www.ossez.com/t/topic/14022)

View File

@ -1,5 +0,0 @@
# Java 核心编程
[](concept.md ':include')
[](data-type.md ':include')

View File

@ -1,2 +0,0 @@
# 基本概念

View File

@ -1,2 +0,0 @@
# 数据类型

View File

@ -1,2 +0,0 @@
# 异常处理

View File

@ -1,2 +0,0 @@
# 语言基础

View File

@ -1,2 +0,0 @@
# I/O 操作

View File

@ -1,2 +0,0 @@
# 语言结构

View File

@ -1,2 +0,0 @@
# 方法和函数

View File

@ -1,2 +0,0 @@
# 反射

View File

@ -1,3 +0,0 @@
# JVM

View File

@ -1,3 +0,0 @@
# 多线程

View File

@ -1,3 +0,0 @@
# 新特性

View File

@ -1,12 +1,12 @@
有关本文档的快速链接,请参考页面提示:
| 链接名称 | URL | 内容说明 |
|----------------|-------------------------------------------------------------------------|------------------------------------|
| GitHub MD 源代文件 | https://github.com/cwiki-us-docs/cwikius-docs/blob/master/jwt/README.md | 将本页面中的内容转换为 MD 文件的手册,并存于 Github 上面 |
| Docsify 转换后的手册 | https://cwiki-us-docs.github.io/cwikius-docs/#/jwt/README | 将 MD 文件使用 Docsify 转换后的手册链接地址 |
| 问题讨论和社区 | https://www.ossez.com/tag/jwt | 请访问使用 JWT 标签 |
| CWIKI.US 页面链接 | https://www.cwiki.us/display/CWIKIUSDOCS/JWT+-+JSON+Web+Token | Confluence 平台的原始翻译文件更新地址 |
| 链接名称 | URL | 内容说明 |
|---|---|---|
| GitHub MD 源代文件 | https://github.com/cwiki-us-docs/cwikius-docs/blob/master/jwt/README.md | 将本页面中的内容转换为 MD 文件的手册,并存于 Github 上面|
| Docsify 转换后的手册 | https://cwiki-us-docs.github.io/cwikius-docs/#/jwt/README | 将 MD 文件使用 Docsify 转换后的手册链接地址 |
| 问题讨论和社区 | https://www.ossez.com/tag/jwt | 请访问使用 JWT 标签 |
| CWIKI.US 页面链接 | https://www.cwiki.us/display/CWIKIUSDOCS/JWT+-+JSON+Web+Token| Confluence 平台的原始翻译文件更新地址 |
**NEW:** 获得 [免费的 JWT 手册JWT Handbook](https://auth0.com/resources/ebooks/jwt-handbook) 同时学习更多有关 JWT 的内容!

Binary file not shown.

Before

Width:  |  Height:  |  Size: 32 KiB

View File

@ -1,549 +0,0 @@
# MessagePack 文档
中文标题【MessagePack Java 0.6.X 快速开始指南】
MessagePack 的相关文档,本文是根据官方的内容和我们项目中的具体实践进行编辑的。
![messagepack logo](_images/messagepack-logo.jpg)
> :warning: 0.6.x 版本的 MessagePack 已经过期被淘汰了。如果你现在开始使用 MessagePack 话,请不要使用这个版本。
我们在这里保留 0.6.x 版本的内容主要用于参考用途。
最新的 MessagePack 版本请参考: https://github.com/msgpack/msgpack-java 中的项目源代码。
:information_source: MessagePack 中文文档请参考: http://docs.ossez.com/messagepack-docs/index.html
:information_source: MessagePack 测试和示例源代码: https://github.com/cwiki-us-demo/serialize-deserialize-demo-java
这个指南提供了使用 msgpack-java 的快速指南。在开始的时候,我们将会介绍如何安装 msgpack-java然后将会运行如何使用 msgpack 来对对象序列化/反序列化serialize/deserizalize对象。
## 安装
你可以使用下面 2 种方法来安装 msgpack-java —— 从 maven 下载或者直接构建 jar 包。
### 从 Maven2 仓库中进行安装
MessagePack 针对 Java 的使用已经发布到 Maven 的中央仓库中Maven Central Repository。你可以使用下面的参数来配置你项目的 pom.xml 文件。
````xml
<dependency>
<groupId>org.msgpack</groupId>
<artifactId>msgpack</artifactId>
<version>${msgpack.version}</version>
</dependency>
````
你需要将 ${msgpack.version} 替换为当前的 MessagePack 版本,有关可以使用的具体版本你可以访问 http://repo1.maven.org/maven2/org/msgpack/msgpack/ 中的版本。
请注意,在 0.6.x 版本中最新的版本只更新到 0.6.12。
### 从 git 仓库中进行安装
你可以从代码仓库中获得最新的代码。
----
```bash
$ git clone git@github.com:msgpack/msgpack-java.git
$ cd msgpack-java
$ mvn package
```
使用上面的代码进行编译后u你将会在 msgpack-java/target 目录中得到 msgpack.jar 包。
同时你也需要 https://code.google.com/p/json-simple/ 和 https://github.com/jboss-javassist/javassist 来让 msgpack.jar 可以在项目中使用。否则你将会收到 NoClassDefFoundError 错误。
## 如何使用
下面是如何使用的示例代码。
### 使用一个消息打包message-packable
使用注解 '_@Message_' 来让你可以序列化你自己类中对象的 public 字段。
本代码可以在 https://github.com/cwiki-us-demo/messagepack-6-demo-java/blob/master/src/test/java/com/insight/demo/msgpack/MessagePack6Object.java 中下载到本地后进行编译测试。
```java
package com.insight.demo.msgpack;
import org.junit.Test;
import org.msgpack.MessagePack;
import org.msgpack.annotation.Message;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.util.UUID;
import static org.junit.Assert.assertEquals;
/**
* MessagePack6Objects
*
* @author yhu
*/
public class MessagePack6Object {
final Logger logger = LoggerFactory.getLogger(MessagePack6Object.class);
/**
* MessageData Message Object
*/
@Message // Annotation
public static class MessageData {
// public fields are serialized.
public String uuid;
public String name;
public double version;
}
/**
* Test MessagePack6Objects
*/
@Test
public void testMessagePack6Objects() {
logger.debug("MessagePack6Objects for Objects");
String uuid = UUID.randomUUID().toString();
// INIT OBJ
MessageData src = new MessageData();
src.uuid = uuid;
src.name = "MessagePack6";
src.version = 0.6;
try {
MessagePack msgPack = new MessagePack();
// Serialization
logger.debug("------ Serialization ------");
byte[] bytes = msgPack.write(src);
logger.debug("Bytes Array Length: [{}]", bytes.length);
// Deserialization
logger.debug("------ Deserialization ------");
MessageData dst = msgPack.read(bytes, MessageData.class);
logger.debug("Check Object for UUID: [{}]", dst.uuid);
assertEquals(uuid, dst.uuid);
} catch (Exception ex) {
logger.error("MessagePack Serialization And Deserialization error", ex);
}
}
}
```
如果你希望按照顺序序列化多个对象的话,你可以使用 '_Packer_' 和 '_Unpacker_' 多个对象。
这是因为 '_MessagePack.write(Object)_' 和 '_read(byte[])_' 实际上每次都调用创建了 '_Packer_' 和 '_Unpacker_' 对象。
为了使用 '_Packer_' 和 '_Unpacker_' 对象,请调用 '_createPacker(OutputStream)_' 和 '_createUnpacker(InputStream)_'。
本代码可以 https://github.com/cwiki-us-demo/messagepack-6-demo-java/blob/master/src/test/java/com/insight/demo/msgpack/MessagePack6Objects.java 中查看。
```java
package com.insight.demo.msgpack;
import org.junit.Test;
import org.msgpack.MessagePack;
import org.msgpack.annotation.Message;
import org.msgpack.packer.Packer;
import org.msgpack.unpacker.Unpacker;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.util.UUID;
import static org.junit.Assert.assertEquals;
/**
* MessagePack6Objects
*
* @author yhu
*/
public class MessagePack6Objects {
final Logger logger = LoggerFactory.getLogger(MessagePack6Objects.class);
/**
* MessageData Message Objects
*/
@Message // Annotation
public static class MessageData {
// public fields are serialized.
public String uuid;
public String name;
public double version;
}
/**
* Test MessagePack6Objects
*/
@Test
public void testMessagePack6Objects() {
logger.debug("MessagePack6Objects for Objects");
String uuid = UUID.randomUUID().toString();
// INIT OBJ
MessageData src1 = new MessageData();
src1.uuid = uuid;
src1.name = "MessagePack6-src1";
src1.version = 0.6;
MessageData src2 = new MessageData();
src2.uuid = uuid;
src2.name = "MessagePack6-src2";
src2.version = 10.6;
MessageData src3 = new MessageData();
src3.uuid = uuid;
src3.name = "MessagePack6-src3";
src3.version = 1.6;
try {
MessagePack msgPack = new MessagePack();
// Serialization
logger.debug("------ Serialization ------");
ByteArrayOutputStream out = new ByteArrayOutputStream();
Packer packer = msgPack.createPacker(out);
packer.write(src1);
packer.write(src2);
packer.write(src3);
byte[] bytes = out.toByteArray();
logger.debug("Bytes Array Length: [{}]", bytes.length);
// Deserialization
logger.debug("------ Deserialization ------");
ByteArrayInputStream in = new ByteArrayInputStream(bytes);
Unpacker unpacker = msgPack.createUnpacker(in);
MessageData dst1 = unpacker.read(MessageData.class);
MessageData dst2 = unpacker.read(MessageData.class);
MessageData dst3 = unpacker.read(MessageData.class);
logger.debug("Check Object for UUID: [{}]", dst1.uuid);
assertEquals(uuid, dst1.uuid);
} catch (Exception ex) {
logger.error("MessagePack Serialization And Deserialization error", ex);
}
}
}
```
### 多种类型变量的序列化和反序列化serialization/deserialization
类 '_Packer/Unpacker_' 允许序列化和反序列化多种类型的变量,如后续程序所示。这个类启用序列化和反序列化多种类型的变量和序列化主要类型变量以及包装类,'_String_' 对象,
'_byte[]_' 对象,'_ByteBuffer 对象等的方法相似。
如上面提示的,你可以序列化和反序列化你自己的对象,前提是你自己的对象需要使用 '_@Message_' 注解。
本代码可以在 https://github.com/cwiki-us-demo/messagepack-6-demo-java/blob/master/src/test/java/com/insight/demo/msgpack/MessagePack6Types.java 中查看。
```java
package com.insight.demo.msgpack;
import org.junit.Test;
import org.msgpack.MessagePack;
import org.msgpack.packer.Packer;
import org.msgpack.unpacker.Unpacker;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.math.BigInteger;
import java.nio.ByteBuffer;
/**
* MessagePack6Types
*
* @author yhu
*/
public class MessagePack6Types {
final Logger logger = LoggerFactory.getLogger(MessagePack6Types.class);
/**
* Test MessagePack6Types
*/
@Test
public void testMessagePack6Types() {
logger.debug("testMessagePack6Types for Types");
MessagePack msgpack = new MessagePack();
try {
//
// Serialization
//
ByteArrayOutputStream out = new ByteArrayOutputStream();
Packer packer = msgpack.createPacker(out);
// Serialize values of primitive types
packer.write(true); // boolean value
packer.write(10); // int value
packer.write(10.5); // double value
// Serialize objects of primitive wrapper types
packer.write(Boolean.TRUE);
packer.write(new Integer(10));
packer.write(new Double(10.5));
// Serialize various types of arrays
packer.write(new int[]{1, 2, 3, 4});
packer.write(new Double[]{10.5, 20.5});
packer.write(new String[]{"msg", "pack", "for", "java"});
packer.write(new byte[]{0x30, 0x31, 0x32}); // byte array
// Serialize various types of other reference values
packer.write("MessagePack"); // String object
packer.write(ByteBuffer.wrap(new byte[]{0x30, 0x31, 0x32})); // ByteBuffer object
packer.write(BigInteger.ONE); // BigInteger object
//
// Deserialization
//
byte[] bytes = out.toByteArray();
ByteArrayInputStream in = new ByteArrayInputStream(bytes);
Unpacker unpacker = msgpack.createUnpacker(in);
// to primitive values
boolean b = unpacker.readBoolean(); // boolean value
int i = unpacker.readInt(); // int value
double d = unpacker.readDouble(); // double value
// to primitive wrapper value
Boolean wb = unpacker.read(Boolean.class);
Integer wi = unpacker.read(Integer.class);
Double wd = unpacker.read(Double.class);
// to arrays
int[] ia = unpacker.read(int[].class);
Double[] da = unpacker.read(Double[].class);
String[] sa = unpacker.read(String[].class);
byte[] ba = unpacker.read(byte[].class);
// to String object, ByteBuffer object, BigInteger object, List object and Map object
String ws = unpacker.read(String.class);
ByteBuffer buf = unpacker.read(ByteBuffer.class);
BigInteger bi = unpacker.read(BigInteger.class);
} catch (Exception ex) {
logger.error("MessagePack Serialization And Deserialization error", ex);
}
}
}
```
方法 '_Packer#write()_' 允许序列化多种类型的数据。
类 '_Unpacker_' 针对反序列化二进制数据为主要变量,提供了一个反序列化方法。例如,你希望将二进制数据反序列化为 '_boolean_' (或者 '_int_') 数据类型,你可以使用 '_Unpacker_' 中的 '_readBoolean_' (或者 '_readInt_') 方法。
'_Unpacker_' 同时也为参考变量提供了一个读取的方法。这个方法允许为一个参考变量从二进制数据中进行反序列化。参考变量的定义为你将类型指定为一个参数。
例如,你希望反序列化二进制数据到 '_String_' (或者 '_byte[]_') 对象,你必须在调用 '_read(String.class)_' (或者 '_read(byte[].class)_') 方法的时候定义描述。
## List, Map 对象的序列化和反序列化serialization/deserialization
为了序列化原生的容器对象例如 '_List_' 和 '_Map_' 对象,你必须使用 '_Template_'。
'_Template_' 对象是 serializer 和 deserializer 的配对。例如,为了序列化一个 '_List_' 对象,在 '_List_' 对象中 '_Integer_' 对象为元素你可以使用下面的方法来创建一个模板对象Template object
```java
Template listTmpl = Templates.tList(Templates.TInteger);
```
类 '_tList_' '_TInteger_' 是静态方法,字段为 '_Templates_'。
一个 '_List 和 '_Map_' 对象的用例如下显示:
本代码可以在 https://github.com/cwiki-us-demo/messagepack-6-demo-java/blob/master/src/test/java/com/insight/demo/msgpack/MessagePack6Template.java 中查看。
```java
package com.insight.demo.msgpack;
import org.junit.Test;
import org.msgpack.MessagePack;
import org.msgpack.packer.Packer;
import org.msgpack.template.Template;
import org.msgpack.unpacker.Unpacker;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.math.BigInteger;
import java.nio.ByteBuffer;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import static org.msgpack.template.Templates.*;
/**
* MessagePack6Template
*
* @author yhu
*/
public class MessagePack6Template {
final Logger logger = LoggerFactory.getLogger(MessagePack6Template.class);
/**
* Test MessagePack6Template
*/
@Test
public void testMessagePack6Template() {
logger.debug("MessagePack6Template for Template");
MessagePack msgpack = new MessagePack();
try {
// Create templates for serializing/deserializing List and Map objects
Template<List<String>> listTmpl = tList(TString);
Template<Map<String, String>> mapTmpl = tMap(TString, TString);
//
// Serialization
//
ByteArrayOutputStream out = new ByteArrayOutputStream();
Packer packer = msgpack.createPacker(out);
// Serialize List object
List<String> list = new ArrayList<String>();
list.add("msgpack");
list.add("for");
list.add("java");
packer.write(list); // List object
// Serialize Map object
Map<String, String> map = new HashMap<String, String>();
map.put("sadayuki", "furuhashi");
map.put("muga", "nishizawa");
packer.write(map); // Map object
//
// Deserialization
//
byte[] bytes = out.toByteArray();
ByteArrayInputStream in = new ByteArrayInputStream(bytes);
Unpacker unpacker = msgpack.createUnpacker(in);
// to List object
List<String> dstList = unpacker.read(listTmpl);
// to Map object
Map<String, String> dstMap = unpacker.read(mapTmpl);
} catch (Exception ex) {
logger.error("MessagePack Serialization And Deserialization error", ex);
}
}
}
```
### 不使用注解annotations来序列化
如果你不能添加 @Message 到你的定义对象中但是你还是希望进行序列化。你可以使用 register 方法来在类中启用序列化对象。
如下的代码所示:
```java
MessagePack msgpack = new MessagePack();
msgpack.register(MyMessage2.class);
```
例如,如果 MyMessage2 类被包含到了外部的库中了。你没有办法比较容易的编辑源代码,添加 '_@Message_' 到源代码中。
register 方法能够允许为 MyMessage2 自动创建一个 serializer 和 deserializer 对。
你可以在执行方面后序列化对象 MyMessage2。
### 可选字段
你可添加一个新的字段来保持可用性。在新字段中使用 '_@Optional_' 注解。
```java
@Message
public static class MyMessage {
public String name;
public double version;
// new field
@Optional
public int flag = 0;
}
```
如果你尝试反序列化老版本数据的话,可选字段将会被忽略。
### 动态类型
我们知道 Java 是一个静态类型的语言。通过输入 '_Value_' MessagePack能够实现动态的特性。
'_Value_' 有方法来检查自己的类型('_isIntegerType()_', '_isArrayType()_', 等...),同时也转换为自己的类型 ('_asStringValue()_', '_convert(Template)_')。
本代码可以在 https://github.com/cwiki-us-demo/messagepack-6-demo-java/blob/master/src/test/java/com/insight/demo/msgpack/MessagePack6DynamicTyping.java 中查看。
```java
package com.insight.demo.msgpack;
import org.junit.Test;
import org.msgpack.MessagePack;
import org.msgpack.type.Value;
import org.msgpack.unpacker.Converter;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.util.ArrayList;
import java.util.List;
import static org.msgpack.template.Templates.TString;
import static org.msgpack.template.Templates.tList;
/**
* MessagePack6Objects
*
* @author yhu
*/
public class MessagePack6DynamicTyping {
final Logger logger = LoggerFactory.getLogger(MessagePack6DynamicTyping.class);
/**
* Test MessagePack6Objects
*/
@Test
public void MessagePack6DynamicTyping() {
logger.debug("MessagePack6Objects for Objects");
// Create serialize objects.
List<String> src = new ArrayList<String>();
src.add("msgpack");
src.add("kumofs");
src.add("viver");
MessagePack msgpack = new MessagePack();
try {
// Serialize
byte[] raw = msgpack.write(src);
// Deserialize directly using a template
List<String> dst1 = msgpack.read(raw, tList(TString));
// Or, Deserialze to Value then convert type.
Value dynamic = msgpack.read(raw);
List<String> dst2 = new Converter(dynamic).read(tList(TString));
} catch (Exception ex) {
logger.error("MessagePack Serialization And Deserialization error", ex);
}
}
}
```

Binary file not shown.

Before

Width:  |  Height:  |  Size: 27 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 32 KiB

View File

@ -1,222 +0,0 @@
# Protocol Buffers 文档
Protocol Buffers 相关文档的内容。
![protocol-buffers-logo](_images/protocol-buffers-logo.jpg)
## Protocol Buffers 简介
如果你在互联网上搜索的话,你可能会看到下面的说明文字。
Google Protocol Buffer( 简称 Protobuf) 是 Google 公司内部的混合语言数据标准,目前已经正在使用的有超过 48,162 种报文格式定义和超过 12,183 个 .proto 文件。
他们用于 RPC 系统和持续数据存储系统。
Protocol Buffers 是一种轻便高效的结构化数据存储格式,可以用于结构化数据串行化,或者说序列化。
它很适合做数据存储或 RPC 数据交换格式。可用于通讯协议、数据存储等领域的语言无关、平台无关、可扩展的序列化结构数据格式。
目前提供了 C++、Java、Python 三种语言的 API。
我们是在实际的数据处理的时候,需要使用 JSON 来序列化数据,但是又考虑到 JSON 在传输的时候数据过大,同时还有很多并不需要的垃圾文件。
我们才考虑到了 Protocol Buffer 提供的功能。
![protocol-buffers-serialization](_images/protocol-buffers-serialization.png)
# Protocol Buffers 开发者指南
欢迎来到 protocol buffers 的开发者指南。protocol buffers 是一个语言中立,平台中立针对通讯协议,数据存储和其他领域中对结构化数据进行序列化的扩展方法。
本文档主要针对的是 JavaC++ 或 Python 的开发人员希望在开发的应用程序中使用 Protocol Buffers。这个有关 Protocol Buffers 摘要性的介绍将会告诉你如何开始使用 Protocol Buffers。
如果你希望更加深入的了解有关 Protocol Buffers 的内容,你可以进入 tutorials 或者 protocol buffer encoding 页面来详细了解。
有关 API 的参考文档请参考页面reference documentation 这里提供了所有这 3 种语言的参考,同时也针对 .proto language 和 style 提供相关的指南。
## 什么是 Protocol Buffers
Protocol buffers 是对结构化数据序列化的一个灵活,高效,自动化工具 —— 你可以将 Protocol buffers 想象成 XML但是体积更小更快也更加简单。
你可以自己定义你的结构化数据,然后你可以使用特定的代码生成工具来非常容易对你的结构化数据进行读取和写入。这些数据的读取和写入可以是一系列的数据流和使用不同的计算机程序语言。
你甚至可以在不对已经部署的程序进行破坏的情况下更新你的数据结构。
## Protocol Buffers 是如何进行工作的
你需要制定你希望如何将你的数据进行序列化。你是通过 proto 文件来定义你的消息结构化数据的。
每一 protocol buffer message 是一个小的信息记录逻辑,这个消息中包含有一系列的名字,变量对照序列。
下面是一些基本的.proto 文件,这些文件中定义了一个消息,这个消息包含有一个 person 信息:
```
message Person {
required string name = 1;
required int32 id = 2;
optional string email = 3;
enum PhoneType {
MOBILE = 0;
HOME = 1;
WORK = 2;
}
message PhoneNumber {
required string number = 1;
optional PhoneType type = 2 [default = HOME];
}
repeated PhoneNumber phone = 4;
}
```
通过上面你可以看到这个消息的格式非常简单—— 每一个消息类型都有一个或者多个唯一进行编号的字段,每一个字段包含有一个名字和变量类型。
变量可以为数字整形或者浮点型numbers布尔类型booleans字符串strings原生二进制raw bytes甚至其他的 protocol buffer 消息类型,能够允许你分级的结构化你的数据。
你可以将字段指定为可选字段optional fields必须字段required fields和重复字段repeated fields。你可以从下面的 Protocol Buffer Language Guide 页面中找到更多有关 .proto 的定义。
一旦你成功定义了你的消息,你可以针对你使用的语言使用你定义的 .proto 来运行 protocol buffer 编译器protocol buffer compiler来生成数据访问类。
针对每一个字段,在数据访问类中提供了简单的访问方法(例如 name() 和 set_name())和序列化到原生 2 进制数据和从原生 2 进制数据反序列化的方法。
针对上面的定义,如果你现在使用的是 C++ 语言的话,当你把消息定义进行编译后,你将会得到一个称为 Person 的类。对数据进行序列化和从序列化的数据中protocol buffer 消息)重新获得 Person 数据。
然后你可以写一些类似 Person person; 的代码。
```cpp
Person person;
person.set_name("John Doe");
person.set_id(1234);
person.set_email("jdoe@example.com");
fstream output("myfile", ios::out | ios::binary);
person.SerializeToOstream(&output);
```
随后,你可以对消息进行读取:
```cpp
fstream input("myfile", ios::in | ios::binary);
Person person;
person.ParseFromIstream(&input);
cout << "Name: " << person.name() << endl;
cout << "E-mail: " << person.email() << endl;
```
你可以向你的消息中添加新的字段而不会损坏老的消息。这是因为在老的消息处理中,针对新的字段是完全忽略掉的。因此,如果你在你的通讯协议中使用 protocol buffers 为数据结构的话,
你可以对你的协议和消息进行扩展而不需要担心老的代码没有办法编译通过,或者损坏老的代码。
你可以访问 API Reference section 页面中的内容来了解完整 protocol buffer 代码的生成和使用。
你也可以在 Protocol Buffer Encoding 页面中了解更多protocol buffer 消息是如何进行编码的。
## 为什么不使用 XML
针对 XML 来说 Protocol Buffers 具有更多的优势来对序列化结构数据。
* 更加简单
* 小于 XML 3 到 10 倍
* 快于 XML 20 到 100 倍
* 松耦合
* 使用程序工具来创建数据访问类,使数访问类更加简单
* 假设,你需要讲 person 这个数据进行定义,在 XML 你需要使用:
```xml
<person>
<name>John Doe</name>
<email>jdoe@example.com</email>
</person>
```
来进行定义。
在 Protocol Buffers 中针对上面的消息文本化text format后显示为
```
# Textual representation of a protocol buffer.
# This is *not* the binary format used on the wire.
person {
name: "John Doe"
email: "jdoe@example.com"
}
```
当上面的消息被编码为 Protocol Buffer 二进制格式binary format上面的文字可能小于 28 bytes并且可能需要 100-200 纳秒nanoseconds来进行处理。
我们将上面转换为可以人为读取的目的主要是为进行调试和编辑。
如果你使用 XML 的话,上面的信息至少需要 69 bytes (你需要删除所有的空格),同时你需要 5,000-10,000 纳秒nanoseconds来进行处理。
同时,对 protocol buffer 进行操作也是非常容易的:
```cpp
cout << "Name: " << person.name() << endl;
cout << "E-mail: " << person.email() << endl;
```
如果使用的是 XML 的话,你需要进行下面的操作:
```cpp
cout << "Name: "
<< person.getElementsByTagName("name")->item(0)->innerText()
<< endl;
cout << "E-mail: "
<< person.getElementsByTagName("email")->item(0)->innerText()
<< endl;
```
但是protocol buffers 并不是任何时候都会比 XML 好。例如针对基于文本的标记语言例如XMLprotocol buffers 就不是一个很好的选项,
因为你不能使用 protocol buffer 更好的在文档中进行交换。更主要的是 HTML 是人类可以阅读和编辑的。protocol buffer 也不是不可以人为的读取,但是针对原生的 protocol buffer 格式是没有办法人为进行读取和编辑的。
XML 与 HTML 一样在某种程度上是一种自我描述数据。protocol buffer 只针对你在 .proto 文件中描述的内容进行表达。
## 看起来像一个解决方案,我应该如何开始呢
Download the package 这包中含有针对 Java, Python, 和 C++ protocol buffer 编译器源代码,和你需要进行 I/O 和测试的类。希望对你的编译器进行编译和构建,请参考代码中的 README 文件。
一旦你完成了所有的设置,请参考 tutorial 页面中的内容来选择你需要的语言——这个能够帮助你使用 protocol buffer 创建一个简单的应用程序。
## 介绍 proto3
在我们最新的 version 3 发行版 中推出了新的语言版本 —— Protocol Buffers language version 3另称 proto3在这个版本中针对我们已经存在的语言版本proto2使用了一些新的特性。
Proto3 简化了 protocol buffer 语言,使其更加容易使用并且能够支持更多的语言:我们当前发行的 proto3 能够让你创建 Java, C++, Python, Java Lite, Ruby, JavaScript, Objective-C, and C#。
另外你也可以通过使用 Go protoc 插件来用 proto3 创建 Go 代码,这个插件你可以到 golang/protobuf Github 中下载到。更多的语言还在逐步进行支持中。
请注意,这 2 个版本的 API 并不是完全兼容的。为了照顾还在使用老版本的用户,我们将会在新的 protocol buffers 发行中同时支持老的版本。
你可以在下面的发行日志release notes查看 2 个版本的主要不同。有关 proto3 的句法,请参考 Proto3 Language Guide 中的内容,针对 proto3 的完整文档还没有编写完成,将会随后推出。
看起来 proto2 和 proto3 可能会产生一些混淆,这是因为原始的开源 protocol buffers 实际上是 Google 内部语言的第二个版本,同时我们的开源版本也是从 v2.0.0 开始的。
简单来说就是 proto 最开始的版本是 Google 内部使用的,在 proto 第二个版本的时候Google 决定进行开源了,所以开源的 proto 是从 proto2 开始的。
## 一个简短的历史
Protocol buffers 最开始是在 Google 内部进行开发的,用于处理在索引服务器上请求/响应request/response的协议。
在 Protocol buffers 之前,针对请求和响应,使用的是 marshalling/unmarshalling这个能够支持一系列的协议。但是结果看起来却是非常的难看例如
```
if (version == 3) {
...
} else if (version > 4) {
if (version == 5) {
...
}
...
}
```
明确格式化的的协议也使新版本的协议更加难以推出,这是因为开发者必须能够了解老协议在服务器之间是如何进行处理的,同时也需要了解新的协议。只有对新老协议都有所了解后才能逐步使用新的协议替换老的协议。
Protocol buffers 被用来设计解决上面的很多问题:
* 新的字段比较能够容易的进行定义,中级服务器不需要对数据进行检查,直接对数据进行处理,同时也可以直接传输数据而不需要了解数据是如何进行定义的。
* 格式使用自描述能够更加容易支持更多的语言C++Java 等)。
但是用户还是需要手动书写他们自己的处理diam。
作为系统的进化来说,它获得了许多其他的特性和用途:
* 自动生成序列化和反序列化代码而避免手动书写这些代码。
* 除了开始使用短期RPC远程过程调用请求人们开始使用 protocol buffers 作为高效的自描述结构化数据格式(主要针对数据短期存在,例如在 Bigtable
* 服务器RPC接口开始被声明为协议文件的一部分协议编译器生成根类用户可以通过服务器接口的实现和重载它们。
Protocol buffers 在 Google 中成为针对数据的通用语言—— 随着时间的流逝,在 Google 内部已经有超过 348,952 .proto 文件被定义。这些被用在 RPC 系统和存储系统中存储数据。
[Annotation注解](installation.md ':include')

View File

@ -1,40 +0,0 @@
# Protocol Buffers 安装
本文主要介绍 protobuf 编译器在 Windows 下的安装。
## 下载编译器
访问 https://github.com/protocolbuffers/protobuf/releases/ 链接然后针对不同的操作系统下载最新的编译器版本。
![protobuf-windows-01|475x500](https://cdn.ossez.com/discourse-uploads/original/2X/1/1dd39bd466048c1f7f5067e1605f396898dd873a.png)
下载完成后到本地计算机上找到这个文件并且解压。
## 解压文件
然后将下载的压缩文件解压到 D:\Dkits\protobuf 文件夹中。
当然你也可以解压到不同的文件夹中。
![protobuf-windows-02|690x281](https://cdn.ossez.com/discourse-uploads/original/2X/3/3e227fcacdddbdd7a5769b9e03f05a356dcb0fd0.png)
解压后的文件夹目录如下。
## 设置 PATH
当完成下面解压后,你可以将文件所在的 bin 目录中设置到 PATH 里面。
![protobuf-windows-03|528x500](https://cdn.ossez.com/discourse-uploads/original/2X/2/27bd6464431fa25136684e8f03e48255fc369c40.png)
上面就是设置好的 PATH 目录。
然后保存退出。
## 校验安装
在命令行工具中,运行命令:
`protoc --version`
如果能够看到版本输出的话,就说明你的 protoc 已经被正确的配置到操作系统中了。
![protobuf-windows-04|690x369](https://cdn.ossez.com/discourse-uploads/optimized/2X/9/9be96ab271c416ad37e06a641348cecae7ff9c52_2_690x369.png)
如上图,我们能看到正确的版本输出。
延伸阅读和参与讨论,请访问:[Protobuf 编译器 Windows 安装方法](https://www.ossez.com/t/protobuf-windows/13864)

Binary file not shown.

Before

Width:  |  Height:  |  Size: 9.9 KiB

View File

@ -1,42 +0,0 @@
# 面试问题和经验文档
在应聘技术岗位的时候,通常会要求你进行一些算法和基础知识的考核。因计算机的知识比较复杂概念也非常多,这就给应聘者带来很大的困惑,应该怎么去做?
同时面试官很多时候也是突击某个问题,然后拿着这个问题来问应聘者。结果就导致了很多问题非常刁钻古怪,甚至有时候你根本就不可能在实际开发中遇到。
不管怎么样,这种面试方式至少目前来说是一种趋势,所以我们尽量收集一些技术岗的面试经验供大家参考。
![it-job-interview](_images/it-job-interview.jpg)
因为 MD 文档格式的限制,所以我们在这里只放一个索引并且维护这个索引,有关的具体内容,请通过索引访问我们的社区进行查看,我们也非常欢迎您参与讨论,
您可以在社区注册后进行讨论。
## CS 基础
如果你有比较好的 CS 基础,那么下面的内容肯对你来说可能就太基础了。
如果你没有 CS 基础,但是想转成 CS 并且需要进行一些面试下面的这些内容也许能帮你想想盒子外面有什么Thinking outside the box顺便能够过一下 CS 的原理和概念。
* [为什么要转码](https://www.ossez.com/t/topic/13891)
*
## 面试问题和经验索引
在这里我们希望按照年份进行一些分开,这样能够帮助大家尽量区分时间,同时我们的排序是按照倒序排列的。
最新的内容在最前面(按照时间倒序排序)。
### 2023
### 2021
* [一次谈不上有点内卷的美东某金融公司面试](https://www.ossez.com/t/topic/13820)
* [美东某 IoT 公司技术流程第一轮沟通就挂了](https://www.ossez.com/t/iot/13815)
* [2021 年美东地区 IoT 公司的一次失败面试](https://www.ossez.com/t/2021-iot/13791)
* [2021 年一次比较奇葩的 AWS 面试](https://www.ossez.com/t/2021-aws/13788)
* [2021 疫情期间美国公司技术岗的面试流程](https://www.ossez.com/t/topic/13463)
* [从拒绝到被拒绝](https://www.ossez.com/t/topic/13462)
* [从一个工作到一个工作](https://www.ossez.com/t/topic/13461)
* [北美亚特兰大一金融服务公司面试总结](https://www.ossez.com/t/topic/13453)
* [北美一工作搜索引擎公司技术岗面经](https://www.ossez.com/t/topic/13451)
* [一房地产数据服务初创公司的面经](https://www.ossez.com/t/topic/13441)
### 2019
* [IT 技术岗位 2019 年北美求职流水账](https://www.ossez.com/t/it-2019/13433)

View File

@ -1,23 +0,0 @@
# 职场
裁员和被裁员都没有什么关系,这是公司正常经营中的一部分,很多人在全部的职场生涯中都会经历很多次。
有人可能会觉得奇怪为什么对这次公司的情况为什么有这么多内容。
这是因为这次出现的情况可以说是教科书级别的,以前都是不同的情况,这次的情况实在是有点意思,这个过程真的有太多有意思的地方了。
因此,针对感受分类总结下,供有需要的朋友参考,所有的内容都是基于当前被裁员的公司近一年的状况。
这个帖子就留在这里做一个回顾入口的总帖子吧,下面的内容是根据不同时间和不同内容分类进行汇总的。
按照发布时间的倒序进行排列,最后发表的在最上面。
如想参与支持相关的讨论和分享你的一些经验,请访问 https://www.ossez.com/c/37-category/jobs/19 页面中的内容,我们热忱的期待您的参与和分享。
## 相关文章列表
* [公司大规模裁员的时间轴](https://www.ossez.com/t/topic/14472)
* [来聊聊才离职就被拉黑禁用的这些事](https://www.ossez.com/t/topic/14469)
* [公司裁员日常的骚操作和警告](https://www.ossez.com/t/topic/14465)
* [上一年工作中猫腻的总结](https://www.ossez.com/t/topic/14464)
* [北美 2023 被裁员的感悟](https://www.ossez.com/t/topic/14461)
* [2023 重新开始](https://www.ossez.com/t/topic/14456)