Yiyi Sun - Programming Blog

Service without description is a pain

Too many debates are there about SOAP vs. REST, contract first vs. code first.

But here is my real life experience during developing WB Editor when it needs to connect web services through those famous RESTful style APIs.

First, the API documents usually have no schema definitions other than request and response XML examples.  Examples are good for human to read.  But after reading, where is the code that I can work with? I have to write code to parse those XML! - This is a pain. If there was schema, machine could generate client code stubs automatically. The nice “Add web reference” way.

Second, maybe the web service providers realized the issue mentioned above. Usually there are client libraries are also available, such as libraries for Java, for .NET, for PHP, for Python and for Javascript …. If using libraries, what is the differece between them to those C libraries ages ago? As long as the the library black box can talk to the server no needs to bother whether underneath it is HTTP, whether it is XML or binary.

I cannot imagine if in my company, when I publishing tones of web services to other departments or clients, I have to also deliver client libraries, for Java, for .NET ….

Tags: WB Editor, SOAP, REST, API, schema, Add web reference, web services

Add comment June 8th, 2007

究竟什么是 blog 5 - 需要多少个 blog 服务器

在 究竟什么是 blog 1 - 个人的网上日记 一文中，总结了 blog 的两大特点：个人特点和群体特点。

个人特点是指写什么发布什么应该是很自由的。
群体特点是在具有相同兴趣爱好者之间相互交流。

因此，blog 服务器应该有多个。其中一个是自己的所有文章的汇集，其他是 group blog。自己个人的服务器放全部的文章，并且分门别类地复制发送到其它 group blog 服务器上 (cross post)。

应该选什么样的blog 服务商？

blogger.com 等 blog 服务商把 blog 当作个人主页的扩展，这些比较适合架设个人 blog 服务器。 它甚至鼓励在 blog 里面放你自己 google adsense 广告。

另外一些 blog 服务商把 blog 当作论坛的扩展，这个比较适合 group blog 而不适合做个人 blog 服务器。因为它可能会

有个斑竹/管理员什么的来封杀你的内容。
在它自己的首页弄个无聊的阅读排行榜。
因为不知道什么人的内容不好关闭网站，影响你的文章发布。
不允许你放的 google 广告，而放进 (inject) 它自己的google 广告。

要加入 group blog，当然需要遵守它的规则和协议，由它限制内容、放进它的广告 …

而架设自己的个人 blog 服务器，应该有充分的自由，选择个人主页扩展型 blog 服务商为好，免费的服务也可能会有被加上它的页眉等，但是付钱就好了。

如果选不到好的 blog 服务商，自己租个web 服务器(虚拟主机)，可以更加自由地架设自己的 blog 服务器，因为有很多现成的免费的软件。将在下文介绍。

1 comment November 10th, 2004

究竟什么是 blog 4 - 不用写作工具太遗憾

blog 是在网上写日记。可是，就象用 web 浏览器不是唯一看 blog 的方法一样，用 web 浏览器登陆 blog 服务器去写作也不是唯一的写作办法。

写作 blog 可以用专门的写作工具，称为 desktop blog editing tool 或者 posting tool。它们具有更好的类似 word 的操作界面，来更加容易直观控制排版。还可以把 blog 文章、草稿保存到自己机器的硬盘上。甚至还有些有趣的功能，例如，把 windows media player 里面正在播放的音乐信息，插入到你的 blog 中。
http://www.microsoft.com/windowsxp/windowsmediaplayer
/downloads/create.asp

这么好的东西。十分遗憾的是，能支持中文 blog 写作的工具，并不多见。为此，我专门制作了一个 WB Editor。

WB Editor 通过 IBlogExtension 挂接到支持这个接口的程序下，例如 SharpReader，RSS Bandit，NewsGator …

WB Editor 又通过 blogger API å’Œ metaWeblog API 连接众多支持这些标准的 blog 系统，例如，delphibbs, drupal, xoops, .text, b2, nuclues, pmachine, Moveable Type ……

都是标准化的东西，上下通吃，应该前途不错

Add comment November 10th, 2004

究竟什么是 blog 3 - 难道可以不用 Tackback Ping

Tackback Ping 是 blog 一个十分重要的功能，由做 Moveable Type 的人发明的。他们说 TrackBack 是 “a framework for peer-to-peer communication and notifications between web sites”。 (http://www.movabletype.org/docs/mttrackback.html) 厉害了吧，是在 web 网站之间做 P2P 通讯。其实没有必要想那么高深。看看下面这个例子：

你在网上看到一篇 blog，在谈一个算法，而这时候，你自己正在写一篇 blog 谈同样的问题，也许你就会希望看到网上那篇 blog 的人也能来看看你的 blog。这时候改怎么办？习惯于论坛模式的人就会去网上那篇 blog，手工添加一个”评论”/回贴，把自己相关 blog çš„ url 连接贴上去。但是，blog 世界里却不是这样的。

blog 作者可以在发布自己 blog 的同时，会把自己 blog 的 url 连接 ping 到网上那篇 blog 上去，使得看到网上那篇 blog 的人也能 Trackback 顺藤摸瓜、追踪回来看看自己的 blog。在 blog 网站发贴的时候，你会看到有个选项填入 Trackback Ping URL，意思就是让你在发 blog 的同时，把连接同时贴到个什么地方去。

当然，网上那篇 blog 要能够接受你的 ping，并且显示你的 blog 标题和连接，以便别人摸回来，这一切的通讯，就是依据 Trackback Ping 协议。这么描述 Trackback Ping，应该容易理解了。

那么这样 ping / 贴自己的连接出去的重要意义在哪里呢？ 如果看过我的《究竟什么是 blog 1》，你就会知道 blog 是一种个人的创作，你写 blog 就是希望发表自己的东西，保存自己的东西。而且对别人发表的 blog 的评论也要在自己的 blog 里永久保留下来。珍惜自己的写作。 blogger (就是玩 blog 的人) 往往是这样讨论问题和做评论的：把内容写在自己的 blog 里面，Trackback Ping 到人家那里。这个概念是论坛模式里从来没有的，称为 remote commenting。 所以，写 blog，难道可以不用 Tackback Ping？

November 10th, 2004

究竟什么是 blog 1 - 个人的网上日记

blog 是个人的、放在网上的日记。强调个人，其重点是发表自己个人的 blog，没有任何管理员来管束你，想写什么都可以。

所谓 group blog 就是有相同主题的一群人，合在一起写 blog。因为往往是有相同兴趣爱好和专业的人聚集在一起写 blog，好处在于大家相互看得懂，容易获取和交流相关领域的信息。

所以，一般似乎应该有个个人的 blog，然后加入一些 group blog，文章 cross post 出去。

Add comment November 10th, 2004