C++博客-金庆的专栏-随笔分类-5. 软工与管理

TortoiseGit is OK but GitExtensions fails

金庆 — Sun, 24 Apr 2022 06:01:00 GMT

TortoiseGit is OK but GitExtensions fails

GitExtensions and Git fail:

      "git" pull --progress "origin"
git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.
Done
Press Enter or Esc to exit...

But TortoiseGit is OK.

      git.exe pull --progress -v --no-rebase "origin"
From github.com:jinq0123/recastnavigation
= [up to date]      master      -> origin/master
= [up to date]      release-2.0 -> origin/release-2.0
Already up to date.

ssh -T shows that the reason is there is no id files:

      PS d:\github> ssh -vT git@github.com
OpenSSH_for_Windows
debug1: Connecting to github.com [20.205.243.166] port 22.
debug1: Connection established.
debug1: identity file C:\\Users\\jinqing/.ssh/id_rsa type -1
debug1: identity file C:\\Users\\jinqing/.ssh/id_xmss-cert type -1
debug1: Authenticating to github.com:22 as 'git'
debug1: Host 'github.com' is known and matches the ED25519 host key.
debug1: Found key in C:\\Users\\jinqing/.ssh/known_hosts:2
debug1: Will attempt key: C:\\Users\\jinqing/.ssh/id_rsa
debug1: Will attempt key: C:\\Users\\jinqing/.ssh/id_xmss
debug1: SSH2_MSG_SERVICE_ACCEPT received
debug1: Authentications that can continue: publickey
debug1: Next authentication method: publickey
debug1: Trying private key: C:\\Users\\jinqing/.ssh/id_rsa
debug1: Trying private key: C:\\Users\\jinqing/.ssh/id_xmss
debug1: No more authentication methods to try.
git@github.com: Permission denied (publickey).
PS d:\github>

Copy my RSA key file rsa.ppk that TortoiseGit uses as ~/.ssh/id_rsa:

      PS D:\jinqing\github_jinq\recastnavigation> ssh -T git@github.com
Load key "C:\\Users\\jinqing/.ssh/id_rsa": invalid format
git@github.com: Permission denied (publickey).
PS D:\jinqing\github_jinq\recastnavigation>

Open TortoiseGit/bin/puttygen.exe, load rsa.ppk, then Convensionis->Export OpenSSH key as ~/.ssh/id_rsa:

      PS D:\jinqing\github_jinq\recastnavigation> ssh -T git@github.com
Hi jinq0123! You've successfully authenticated, ...

id_rsa begins with:

      -----BEGIN RSA PRIVATE KEY-----

金庆 2022-04-24 14:01 发表评论

命名

金庆 — Thu, 31 Dec 2020 01:45:00 GMT

# 命名

摘自：[警惕软件复杂度困局][1]

软件中的API、方法、变量的命名，对于理解代码的逻辑、范围非常重要，也是设计者清晰传达意图的关键。
然而，在很多的项目里我们没有给Naming /命名足够的重视。

我们的代码一般会和一些项目关联，但是需要注意的是项目是抽象的，而代码是具体的。
项目或者产品可以随意一些命名，如阿里云喜欢用中国古代神话（飞天、伏羲、女娲）命名系统，
K8s也是来自于希腊神话，这些都没有问题。
而代码中的API、变量、方法不能这样命名。

一个不好的例子是前一段我们的Cluster API 被命名为Trident API（三叉戟），
设想一下代码中的对象叫Trident时，我们如何理解在这个对象应该具备的行为？
再对比一下K8s中的资源：Pod, ReplicaSet, Service, ClusterIP，
我们会注意到都是清晰、简单、直接符合其对象特征的命名。名实相符可以很大程度上降低理解该对象的成本。

有人说“Naming is the most difficult part of software engineering”，
或许也不完全是个玩笑话：Naming的难度在于对于模型的深入思考和抽象，而这往往确实是很难的。

需要注意的是：

（a）Intention vs what it is

需要避免用“是什么”来命名，要用“for what / intention”。“是什么”来命名是会很容易将实现细节。
比如我们用 LeakedBarrel做rate limiting，这个类最好叫 RateLimiter，而不是LeakedBarrel：
前者定义了意图（做什么的），后者描述了具体实现，而具体实现可能会变化。
再比如 Cache vs FixedSizeHashMap，前者也是更好的命名。

（b）命名需要符合当前抽象的层级

首先我们软件需要始终有清晰的抽象和分层。
事实上我们Naming时遇到困难，很多就是因为软件已经缺乏明确的抽象和分层带来的表象而已。

[1]https://mp.weixin.qq.com/s?__biz=MzIzOTU0NTQ0MA==&mid=2247498895&idx=1&sn=35b1d00e367c18c3d4ed7d4b15b38996&chksm=e92ac180de5d4896fd5d789ffbe8c963986717b634f2dac09821c2b3ab2270a42f4a1c006ff5&scene=21#wechat_redirect

金庆 2020-12-31 09:45 发表评论

SVN重命名时不要更改内容

金庆 — Fri, 20 Sep 2019 06:45:00 GMT

SVN重命名时不要更改内容

(金庆的专栏 2019.9)

svn rename 某个文件并更改内容后提交，历史就会丢失。
如果 svn rename 后不改内容，立即提交，就可以延续原有历史。
所以改名这样的操作应该独立提交一次。

git 改名就强大多了，会比较内容确定其原来的文件。但更改太多也会判断出错。

金庆 2019-09-20 14:45 发表评论

删除隐性的git submodule

金庆 — Thu, 30 Aug 2018 02:58:00 GMT

删除隐性的git submodule

(金庆的专栏 2018.8)

正常的submodule会在 .gitmodule 文件中，TortoiseGit 会有 Submodule Update 菜单。
还有一种隐性的 submodule, .gitmodule 文件中看不到它，无法 update.
golang开发中的vendor目录下经常会不小心添加一个带 .git 的目录，就变成了一个假的submodule.
用 Repo-browser 看这个目录是个submodule链接, clone 出来就只有一个空目录。

删除这个submodule不能用 git delete, 提交时会报错：

git.exe add -f [...]

fatal: pathspec 'src/vendor/github.com/grpc-ecosystem/grpc-opentracing' did not match any files

git did not exit cleanly (exit code 128)

git delete 父目录也无法提交。

但是可以直接删除（不用git delete）, 然后提交并Push. 好像只有这个办法。

金庆 2018-08-30 10:58 发表评论

用docker stack开启redis集群

金庆 — Thu, 26 Oct 2017 04:08:00 GMT

用docker stack开启redis集群

(金庆的专栏 2017.10)

有5个docker swarm节点，开启redis cluster.
每个机器上开2个redis节点，共10个redis节点。
采用官方的redis:alpine镜像。

docker-stack.yml 如下：

version: "3"
services:
redis001:
    image: redis:alpine
    volumes:
      - /home/redis/001/data:/data
      - /home/redis/001/conf:/conf
    command: redis-server --appendonly yes --cluster-enabled yes --cluster-config-file /conf/nodes.conf --cluster-announce-ip 10.240.79.8 --cluster-announce-port 7001 --cluster-announce-bus-port 17001
    ports:
      - "7001:6379"
      - "17001:16379"
    networks:
      - redisnet
    deploy:
      placement:
        constraints:
          - node.hostname == host-10-240-79-8

redis002:
    image: redis:alpine
    volumes:
      - /home/redis/002/data:/data
      - /home/redis/002/conf:/conf
    command: redis-server --appendonly yes --cluster-enabled yes --cluster-config-file /conf/nodes.conf --cluster-announce-ip 10.240.79.9 --cluster-announce-port 7002 --cluster-announce-bus-port 17002
    ports:
      - "7002:6379"
      - "17002:16379"
    networks:
      - redisnet
    deploy:
      placement:
        constraints:
          - node.hostname == host-10-240-79-9

redis003:
...
redis010:
    ...

networks:
redisnet:

数据保存文件在 /home/redis/001/data
集群配置文件将保存到 /home/redis/001/conf/nodes.conf
各机器上目录需要预先创建，不然docker开启失败。
并且需要设置目录权限，不然报"Permission denied".
redis-server以用户uid=100(redis)运行，所以
    chown -R 100 /home/redis/

启动redis服务栈:
    docker stack deploy -c docker-stack.yml redis

redis-server启动后，运行 redis-trib.rb 来组建 redis cluster:

    docker run --rm -it inem0o/redis-trib create --replicas 1 10.240.79.8:7001 10.240.79.9:7002 ... 10.240.79.12:7010

注意 inem0o/redis-trib 的说明中，命令示例缺少 "-it", 会报错退出：
Can I set the above configuration? (type 'yes' to accept): : undefined method `chomp' for nil:NilClass (NoMethodError)
        from /usr/bin/redis-trib:1295:in `create_cluster_cmd'
        from /usr/bin/redis-trib:1701:in `

'

运行 redis-cli 测试，"-c" 参数表示集群，可连接任意机器的7001-7010任意端口：
[root@host-10-240-79-9 ~]# docker run -it --rm redis:alpine redis-cli -h 10.240.79.8 -p 7006 -c
10.240.79.8:7006> get a
-> Redirected to slot [15495] located at 10.240.79.10:7003
(nil)

用swarm mode开启redis服务比较方便。
但是出于性能考虑，应该禁用 swarm 的NAT转发和负载均衡。
研究了下，暂时还没学会。

金庆 2017-10-26 12:08 发表评论

Lua区分公有私有接口

金庆 — Fri, 18 Aug 2017 10:51:00 GMT

Lua区分公有私有接口

(金庆的专栏 2017.8)

Lua语言没有提供public, private的概念，所有模块或类中的接口都是公有的。

可以通过注释来区分公有私有接口。

ldoc 提供了一个 @section 标签，可用作此功能

--- Test module.
-- @module my_mod
local M = {}

--- Public functions
-- @section public

--- foo.
-- @int a a test input
-- @treturn int result
function M.foo(a)
return a + 1
end

--- Private functions
-- @section private

--- goo.
-- @int a a test input
-- @treturn int result
function M.goo(a)
return a + 2
end

return M

ldoc 生成文档后是这样的：

金庆 2017-08-18 18:51 发表评论

Lua53 premake

金庆 — Sat, 18 Feb 2017 14:18:00 GMT

Lua53 premake

(金庆的专栏 2017.2)

参考：用premake5创建lua532工程
      http://blog.csdn.net/jq0123/article/details/51242780

-- premake5.lua
--[[
Usage examples:
   for windows: premake5.exe --os=windows vs2015
   fot linux:   premake5.exe --os=linux gmake
]]

workspace "lua53"
   configurations { "Debug", "Release" }
   targetdir "bin/%{cfg.buildcfg}"

   language "C++"
   -- Force VS to compile as C++.
   -- https://github.com/premake/premake-core/issues/142
   filter "action:vs*"
      buildoptions "/TP"

   filter "system:windows"
      defines { "LUA_BUILD_AS_DLL" }

   filter "configurations:Debug"
      defines { "DEBUG" }
      flags { "Symbols" }

   filter "configurations:Release"
      defines { "NDEBUG" }
      optimize "On"

project "lua53"
   kind "ConsoleApp"
   files { "src/lua.c" }
   links { "lua53_shared_lib" }

project "luac53"
   kind "ConsoleApp"
   files { "src/luac.c" }
   links { "lua53_static_lib" } -- Link error on Windows if link lua53 shared lib.

project "lua53_shared_lib"
   kind "SharedLib"
   targetname "lua53"
   files { "src/*.h", "src/*.c" }
   removefiles { "src/lua.c", "src/luac.c" }

project "lua53_static_lib"
   kind "StaticLib"
   targetname "lua53"
   filter "system:windows"
      targetprefix "lib" -- liblua53.lib
   filter {}
   files { "src/*.h", "src/*.c" }
   removefiles { "src/lua.c", "src/luac.c" }

更改之处：
* VS强制按C++编译
* 创建动态库和静态库
* lua53.exe 链接动态库，luac53.exe 链接静态库

因为 luac53.exe 链接动态库缺3个函数未导出。
* 添加宏 LUA_BUILD_AS_DLL，不然 lua53.dll 不会生成 lua53.lib

金庆 2017-02-18 22:18 发表评论

ejabberd开发和部署

金庆 — Mon, 31 Oct 2016 09:13:00 GMT

ejabberd开发和部署

(金庆的专栏 2016.10)

搭建了自己的ejabberd集群，然后少量更改源码，实现定制的XMPP服务器。

从github fork ejabberd 库，定为 master 分支跟踪原始库 master 分支，版本升级时从原库合并一次。

从16.09版本分一个 dev 分支，自己的代码就在这个 dev 分支上写。

服务器从源码编译安装。

代码更改后，make install, 然后 ejabberd restart, 或者 ejabberd update all.

如果有配置更改，则还要更改 /etc/ejabberd/ejabberd.yml.

未来主库版本升级后，可重新开个dev2分支，将dev的更改合并到dev2.

金庆 2016-10-31 17:13 发表评论

Windows运行GitStats

金庆 — Tue, 31 May 2016 03:51:00 GMT

Windows运行GitStats

(金庆的专栏)

GitStats - git history statistics generator
http://gitstats.sourceforge.net/

GitStats是git统计工具。
只是一个python脚本，使用 gnuplot 画图。
Windows下运行需要安装 python, git, gnuplot.
需要设置path, 使这些工具可以在命令行中使用。
还需要用到 wc 工具，我的 “Git for Windows” 正好有个 sh.exe, 其中带了 wc,
所以打开 git 的 sh.exe, 进入 GitStats 目录，按说明运行脚本：

jinqing@ZT-2203857 MINGW64 /e/git/gitstats (master)
$ python gitstats /e/server_master /e/temp/server_master

会出现 import gitstats 错误，需要先把 gitstats 复制成 gitstats.py.

结果为 index.html。

因为无法过滤文件，所以统计中都是些其他文件，
例如无法将Lua文件排除，无法排除依赖库。

提供的参数有如下:
jinqing@ZT-2203857 MINGW64 /e/git/gitstats (master)
$ python gitstats

Usage: gitstats [options]

Options:
-c key=value Override configuration value

Default config values:
{'project_name': '', 'processes': 8, 'max_domains': 10, 'commit_begin': '', 'max
_ext_length': 10, 'commit_end': 'HEAD', 'linear_linestats': 1, 'style': 'gitstat
s.css', 'max_authors': 20, 'authors_top': 5, 'start_date': ''}

Please see the manual page for more details.

金庆 2016-05-31 11:51 发表评论

CMake搜索Boost1.57失败及解决

金庆 — Tue, 20 Jan 2015 04:18:00 GMT

CMake更新到3.1.0，Boost更新到1.57，结果CMake搜索Boost失败：

Unable to find the Boost header files. Please set BOOST_ROOT to the root
directory containing Boost or BOOST_INCLUDEDIR to the directory containing
Boost's headers.

已设置环境变量 BOOST_ROOT = C:\Boost

查看 FindBoost.cmake 脚本，发现它仅搜索已知的版本，而最新版 1.57 还未添加：

set(_Boost_KNOWN_VERSIONS ${Boost_ADDITIONAL_VERSIONS}
    "1.56.0" "1.56" "1.55.0" "1.55" "1.54.0" "1.54"
    "1.53.0" "1.53" "1.52.0" "1.52" "1.51.0" "1.51"
    "1.50.0" "1.50" "1.49.0" "1.49" "1.48.0" "1.48" "1.47.0" "1.47" "1.46.1"

添加 “1.57” 后即成功。

FindBoost.cmake 应该添加 Boost 未来版本才好。

金庆 2015-01-20 12:18 发表评论

CMake设置FOLDER失败及解决

金庆 — Sun, 07 Dec 2014 15:11:00 GMT

CMake可以设置FOLDER属性，用来分目录组织VC中的多个工程。

FOLDER: Set the folder name. Use to organize targets in an IDE.
Targets with no FOLDER property will appear as top level entities in IDEs like Visual Studio. Targets with the same FOLDER property value will appear next to each other in a folder of that name. To nest folders, use FOLDER values such as 'GUI/Dialogs' with '/' characters separating folder levels.

方法如下：

Add this to the top level CMakeLists.txt
#Use solution folders.
set_property(GLOBAL PROPERTY USE_FOLDERS ON)

# Then in some target add this to put the target in the Development folder.
set_target_properties(${PROJECT_NAME} PROPERTIES FOLDER Development)

不过VcExpress因为不支持工程目录，所以FOLDER属性无效。

因为机器上同时安装了VC和VcExpress，CMake总是判断为Express版，所以FOLDER设置总是无效。

最终打开sln文件看到了头部的这行才找到问题原因：

# Visual C++ Express

然后在CMake源码中找到了Express版本检测代码：

this->ExpressEdition = cmSystemTools::ReadRegistryValue(
"HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\VCExpress\\14.0\\Setup\\VC;"
"ProductDir", vc14Express, cmSystemTools::KeyWOW64_32);

删除该注册表项就不会被判为Express版了，FOLDER设置成功。

金庆 2014-12-07 23:11 发表评论

代码那些事之命名

金庆 — Tue, 04 Nov 2014 13:00:00 GMT

摘自：代码那些事之命名——《可读代码的艺术》读后感

http://bj007.blog.51cto.com/1701577/1309002

选择具体的词

比如GetPage函数命名中Get就比较空泛，可能有几种情况，比如从文件读取、去远处获取、去数据库查询、或者就是简单地从返回成员变量，如果一切都是Get就需要扒开具体实现才可能确定到底用哪种方式。如果我们可以选择更具体的词，比如文件读取用Read或者Load、远程获取用Fetch、数据库查询用Query、简单返回成员变量时候采用Get，并且整个项目保持一致，可能仅仅看到名字就可以闪现出对应的场景。将信息塞进名字中的一部分就是选择很具体、避免空泛的一些词。

避免误解。

被误解是很受伤的一件事，但是我们的命名就尝尝别误解，而且还常常是整个意思反过来了。因此在检查名字的时候就是主动问下自己“别人对于这个名字是否有不同的解读？”。比如如下代码：

results = Database.all_objects.filter("year <= 2011")

其中，results会包含什么呢？问题就出在filter上，可能是过滤掉、也可能是过滤出。建议就是如果要过滤出，select()会更好，如果要过滤掉，exclude()会更好。

金庆 2014-11-04 21:00 发表评论

TSVN客户端复制文件

金庆 — Sun, 17 Aug 2014 01:44:00 GMT

TSVN客户端复制文件

代码重构中，可能需要将一个大文件拆分成2个小文件，同时要保证拆分后的小文件继承原来的SVN历史记录。

TSVN客户端只有Rename功能，没有Copy功能。

可进入Browser界面，直接在服务器文件列表中复制，但是服务器端复制会产生一个版本，这个版本多半是无法构建的。

用Rename-Revert可在客户端产生文件复制，并保留历史记录。

1. Rename到新的文件。此时旧文件会被删除。

2. Revert被删除的文件。注意新增的文件不要Revert。之后旧文件被恢复。

金庆 2014-08-17 09:44 发表评论

CMake生成版本号

金庆 — Wed, 15 Aug 2012 04:30:00 GMT

CMake生成版本号

（金庆的专栏）

原来的CMake需要用shell脚本生成SVN版本号，再作为cmake参数传入。

CMake调用脚本示例：

#!/bin/sh
# cmake.sh

ServerCodeRoot=~/Code/Server
CodeRevNum=`svn info ${ServerCodeRoot} | grep Revision | awk -F' ' '{ print $2 }'`
cmake S{ServerCodeRoot} -DCMAKE_BUILD_TYPE=Release -DVERSION_REVISION=S{CodeRevNum}

CMakeLists.txt中如下配置：
configure_file(
"Version.h.in"
"Version.h"
)

Version.h.in如下：

#include
const std::string VERSION_MAJOY("1");
const std::string VERSION_MINOR("0");
const std::string VERSION_REVISION("@VERSION_REVISION@");

Linux下执行cmake.sh会自动替换SVN版本号。

现改为用FIND_PACKAGE(Subversion)方式，不必用shell脚本生成SVN版本号，
并且在Windows上也可以生成版本号, cmake调用时不必传VERSION_REVISION参数。

CMakeLists.txt改为（参考了开源网游ryzom的CMake）：

SET(ROOT_DIR ${PROJECT_SOURCE_DIR})
IF(EXISTS "${ROOT_DIR}/.svn/")
FIND_PACKAGE(Subversion)

IF(SUBVERSION_FOUND)
    Subversion_WC_INFO(${ROOT_DIR} Project)
    SET(VERSION_REVISION ${Project_WC_REVISION})
ENDIF(SUBVERSION_FOUND)
ENDIF(EXISTS "${ROOT_DIR}/.svn/")

CONFIGURE_FILE(
"Version.h.in"
"Version.h"
)

如果不是SVN, 而是用Hg, 可用如下脚本：
IF(EXISTS "${ROOT_DIR}/.hg/")
FIND_PACKAGE(Mercurial)

IF(MERCURIAL_FOUND)
    Mercurial_WC_INFO(${ROOT_DIR} ER)
    SET(REVISION ${ER_WC_REVISION})
    SET(CHANGESET ${ER_WC_CHANGESET})
    SET(BRANCH ${ER_WC_BRANCH})
ENDIF(MERCURIAL_FOUND)
ENDIF(EXISTS "${ROOT_DIR}/.hg/")

金庆 2012-08-15 12:30 发表评论

CMake区分debug、release版本

金庆 — Tue, 27 Mar 2012 05:56:00 GMT

摘自： http://www.cppblog.com/tx7do/archive/2010/08/19/124000.html

建立debug/release两目录，分别在其中执行cmake -DCMAKE_BUILD_TYPE=Debug（或Release），需要编译不同版本时进入不同目录执行make即可；

Debug版会使用参数-g；Release版使用-O3 –DNDEBUG

金庆 2012-03-27 13:56 发表评论

数据库的版本控制是必须的

金庆 — Thu, 08 Mar 2012 06:17:00 GMT

摘自：程序员开发利器：源代码管理的十条建议

（ http://tech.it168.com/a2012/0307/1321/000001321198_1.shtml ）

数据库的版本控制是必须的

这是有很多人想做，但是觉得很困难而做不到的一点。这里的问题是，很多应用没有数据库根本无法运行。所以如果你不把数据库加入版本控制的话，你的应用是不完整的。

大部分的版本控制系统只针对文件系统工作，例如 HTML，CSS，图片，配置文件等等任何保存在文件系统中的东西。但是对于数据库中的数据却无能为力。

不过现在也有一些数据库版本控制工具，例如 Red Gate 出品的 SQL Source Control。关于这个工具我曾经写过很详细的文章 Rocking your SQL Sourc Control world with Red Gate，我在这里就不赘述了。总之，数据库的版本控制也很容易了!

金庆 2012-03-08 14:17 发表评论

MySQL无法本地连接

金庆 — Fri, 21 Oct 2011 08:27:00 GMT

MySQL无法本地连接

（金庆的专栏）

Linux重启后，发现不知怎么的MySQL无法本地连接。

结果phpMyAdmin, Zentao都无法正常工作了。

远程的连接用了TCP是正常的，本地连接用了本地socket, 有问题。

本地运行mysql客户端会报错：
Can’t connect to local MySQL server through socket ‘/var/lib/mysql/mysql.sock’ (2)

重启mysql服务也报错：
# service mysql restart
MySQL server PID file could not be found!
Starting MySQL... ...The server quit without updating PID file (/var/lib/mysql/localhost/localdomain.pid)

该.pid文件不存在。所以无法关闭mysql. 正在运行的mysql服务一直无法关闭。

参考：http://zhujipi.com/vps/109.html
说明，Mysql的进程卡死了，这时用就要把这些卡死的进程都关闭。

mysql服务重启成功后恢复正常。

金庆 2011-10-21 16:27 发表评论

设定“svn:needs-lock”属性

金庆 — Wed, 12 Oct 2011 06:33:00 GMT

摘自： http://www.cnblogs.com/LittleFox/archive/2009/04/08/1431781.html

设定“svn:needs-lock”属性
使用命令行锁定“介绍.doc”：

svn propset svn:needs-lock 'x' 介绍.doc

运行这个命令后，“介绍.doc”就已经是设置了“svn:needs-lock ”，但为了使之生效还要运行“svn commit”，之后其他用户update的时候就会发现这个文件已经是只读的了。需要注意的是我们设置的属性值是“x”，实际上任意值都可以， Subversion会忽略其内容。

使用TortoiseSVN设定属性也很简单：

“介绍.doc”右键选中- >属性->Subversion选项夹->properties->add，然后在弹出的窗口中的property name选择“svn:needs-lock”，值任意，然后选择OK。之后再提交“介绍.doc”即可。

金庆 2011-10-12 14:33 发表评论

给VS2005的编辑器添加右边界线

金庆 — Mon, 19 Sep 2011 07:53:00 GMT

转自： http://www.cnblogs.com/duzouzhe/archive/2009/08/05/1539292.html

好的代码风格是生成高质量软件的基础，其中有一点就是代码的每行不能太长，一般建议每行不超过80个字符。
VS2005里面有个隐藏的功能是可以设置编辑器的边界线。创建一个VS2005_Guideline.reg文件，内容为：



Windows Registry Editor Version 5.00

［HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\8.0\Text Editor］

"Guides"="ＲＧＢ(128,0,0) 80, 120"

然后将其导入注册表，重启VS2005后就看到我们创建的两条边界线，分别在80和120的地方（如果只需创建一条边界线，可以把",120"去掉）。使用上面的小技巧我们在写代码时就可以很直观地看到代码是否超过每行规定的边界了。

金庆 2011-09-19 15:53 发表评论

svn日志乱码

金庆 — Mon, 08 Aug 2011 03:12:00 GMT

svn日志乱码

（金庆的专栏）

Windows上用TortoiseSVN提交, 在Linux上查看日志时显示的是乱码.
中文字符变成了一个问号和一个8进制数, 如: ?\227。

将日志输出为xml: svn log -r 123456 --xml > log.xml
然后用iconv手工转成GB2312显示:
iconv -f utf8 -t GB2312 log.xml
就可以发现iconv报告: 未知 nn 处的非法输入序列.

此处是一个横杠, "—", GB2312码为0xa1aa, utf8码为0xe28094,
iconv将svn日志uft8转GB2312时失败, 所以才显示出乱码.

iconv 可以将 0xa1aa 转成 0xe28094, 但是不能反向转.
还有一个稍短点的横杠, 0xe28095, GB2312码为0xa844,
iconv可以从GB2312转成utf8, 但是utf8转GB2312失败.

不知有没有办法让svn忽略无法转换的字符? 这样整条日志还是可以看到.

在linux上svn直接提交的长横杠显示是正常的,
GB码是0xa1aa, xml日志中utf8码是0xe28095.

金庆 2011-08-08 11:12 发表评论

网游更新安全第一

金庆 — Wed, 19 May 2010 09:51:00 GMT

摘要: 对于已经上线的网游服务器，更改代码时要把安全性放在第一位，避免引入错误。
添加某个功能或修正某一个错误时，应该将变更的范围尽量控制在最小范围。
尽量不要造成对其他现有功能的影响。阅读全文

金庆 2010-05-19 17:51 发表评论

C++测试框架的选择

金庆 — Tue, 13 Apr 2010 02:53:00 GMT

摘要: 本文以表格形式总结了 “Exploring the C++ Unit Testing Framework Jungle” ( http://gamesfromwithin.com/exploring-the-c-unit-testing-framework-jungle ) 一文对各种单元测试框架的比较，并添加了原文所还没有加入的Google Test. 并添加了另一项特性比较，即对Mock对象的支持。阅读全文

金庆 2010-04-13 10:53 发表评论

圈复杂度和代码覆盖率

金庆 — Tue, 09 Mar 2010 01:42:00 GMT

摘要: 100%代码覆盖率的单元测试并不代表是足够的测试，下面是一个例子：阅读全文

金庆 2010-03-09 09:42 发表评论

如何保持软件开发团队的稳定性

金庆 — Wed, 20 Jan 2010 05:18:00 GMT

摘要: 保持团队的稳定性说来容易，其实对于每一个优秀的研发经理和公司CEO都非常具有挑战性，尤其是员工很多时候并不能意识到这一点和理解领导层的压力。就好比单身汉不能理解父亲的心情一样。阅读全文

金庆 2010-01-20 13:18 发表评论

随机数生成器应该如何单元测试？

金庆 — Sat, 09 Jan 2010 04:24:00 GMT

摘要: 有个随机数生成函数，按以下分布随机生成1个1-100的整数：90%概率为1-50，10%概率为51-100.
单元测试应该如何进行呢？
生成10000个数然后计算分布比例应该可以，只要在90%上下就算通过。
但是仍有极小可能产生测试失败的可能。
如何做一个具有确定性结论的测试用例？阅读全文

金庆 2010-01-09 12:24 发表评论

你愿意别人更改你的代码吗?

金庆 — Sat, 21 Nov 2009 04:55:00 GMT

摘要: 看到怪盗KID的文章
( http://hi.baidu.com/kidcdf/blog/item/2cefd85c9d13f449fbf2c09f.html )
最后一句: 没有一个人喜欢看着自己辛辛苦苦做的东西被反复删掉重写.

个人觉得别人更改自己写的代码是我乐意接受的. 不知大家有什么想法?

你愿意别人更改你的代码吗?
A) 代码一旦提交, 就是大家公有的代码, 无所谓谁改谁的代码.
B) 很乐意有人愿意更改自己的代码.
C) 绝不允许别人更改自己的代码.
D) 看到自己的代码被人改了,感到很受打击.

还有其他别的感受吗? 阅读全文

金庆 2009-11-21 12:55 发表评论

函数参数的理想个数

金庆 — Mon, 03 Aug 2009 09:35:00 GMT

摘译自:

Clean Code
A Handbook of Agile
Software Craftsmanship
Robert C. Martin

Function Arguments

The ideal number of arguments for a function is
zero (niladic). Next comes one (monadic), followed
closely by two (dyadic). Three arguments (triadic)
should be avoided where possible. More than three
(polyadic) requires very special justification—and
then shouldn’t be used anyway.

函数参数

函数参数的理想个数是零个（零元）。
其次是一个（一元），
紧接下来是两个（二元）。
三个参数（三元）应尽可能地避免。
三个以上的参数（多元）需要非常特殊的理由
————否则无论如何都不应该。

（转载请注明来源于金庆的专栏）

金庆 2009-08-03 17:35 发表评论

SVN中邪恶的replace

金庆 — Thu, 18 Jun 2009 06:53:00 GMT

SVN中邪恶的replace

（转载请注明来源于金庆的专栏）

用TSVN客户端删除一个文件, 然后再新建一个同名文件,
可以看到该文件上的图标被打上了TSVN的小红叉.
然后Add, Commit, 就会出现一条replace记录.
replace的操作会有个提示, 就是Add(as replacement)...命令项与普通的Add不同．

意思应该是该文件被替换了.

邪恶之处是以前的更改日志显示不出来了.
用revision graph可以看到所有历史, 只是在replace处是断裂的.
也就是说替换的效果是重新开启一个文件的更改记录, 隐藏之前的记录.
我想不出什么情况下需要这种功能.

更邪恶的是, revert changes from this revision会失败(TSVN 1.4.3).
错误原因是该文件的上个版本不存在.
好像所有的Add操作都是无法revert, 应该算是个缺陷吧?

为了还原该替换，须删除该文件, 然后revert changes from this revision.

金庆 2009-06-18 14:53 发表评论

测试替身(Test Double)的定义

金庆 — Mon, 18 May 2009 10:52:00 GMT

摘自：http://blog.vsharing.com/wooley/A801453.html

测试替身(Test Double)的定义

测试替身型别	描述
Dummy	最简单、最原始的测试替身型别。Dummy 没有实作，最常用于需要参数值但不使用它的情况。Null 可视为是 Dummy，但真的 Dummy 是接口或基类的衍生，且完全不包含实作。
Stub	Dummy 的上一级，Stub 是接口或基类的最低限度实作。会传回 Void 的方法通常完全不包含实作，而会传回值的方法通常会传回硬式编码的值。
Spy	测试 Spy 类似 Stub，但除了提供客户端可叫用成员的实例，Spy 还会记录叫用了哪些成员，好让单元测试验证所叫用的成员是否符合预期。
Fake	Fake 包含更复杂的实作，通常涉及所继承型别之不同成员之间的互动。虽然不是完整的生产实作，但 Fake 与生产实作很相似，尽管它会采取一些快捷方式。
Mock	Mock 是由 Mock 链接库动态建立 (其他通常是由测试开发人员使用程序代码来产生)。测试开发人员永远看不到实作接口或基类的实际程序代码，但是可以设定 Mock 以提供传回值、预期要叫用的特定成员...等等。视其中的设定而定，Mock 的行为可能会像 Dummy、Stub 或 Spy。

金庆 2009-05-18 18:52 发表评论

解决TSVN的diff显示中文件不全的问题

金庆 — Sat, 14 Feb 2009 05:30:00 GMT

摘要: TortoiseSVN的diff显示中文有些问题, 多数不能完整显示出来. 好像是整个TortoiseSVN对中文字符都有问题, 如blame会崩溃,但是选中"Use test viewer..."用Notepad显示就会正常. 阅读全文

金庆 2009-02-14 13:30 发表评论