/**
     * Describes the Request-For-Enhancement(RFE) that led
     * to the presence of the annotated API element.
     */
    public @interface RequestForEnhancement {
        int    id();
        String synopsis();
        String engineer() default "[unassigned]"; 
        String date();    default "[unimplemented]"; 
    }

    @RequestForEnhancement(
        id       = 2868724,
        synopsis = "Enable time-travel",
        engineer = "Mr. Peabody",
        date     = "4/1/3007"
    )
    public static void travelThroughTime(Date destination) { ... }

    /**
     * Indicates that the specification of the annotated API element
     * is preliminary and subject to change.
     */
    public @interface Preliminary { }

    @Preliminary public class TimeTravel { ... }

    /**
     * Associates a copyright notice with the annotated API element.
     */
    public @interface Copyright {
        String value();
    }

    @Copyright("2002 Yoyodyne Propulsion Systems")
    public class OscillationOverthruster { ... }

    import java.lang.annotation.*;

    /**
     * Indicates that the annotated method is a test method.
     * This annotation should be used only on parameterless static methods.
     */
    @Retention(RetentionPolicy.RUNTIME)
    @Target(ElementType.METHOD)
    public @interface Test { }

    public class Foo {
        @Test public static void m1() { }
        public static void m2() { }
        @Test public static void m3() {
            throw new RuntimeException("Boom");
        }
        public static void m4() { }
        @Test public static void m5() { }
        public static void m6() { }
        @Test public static void m7() {
            throw new RuntimeException("Crash");
        }
        public static void m8() { }
    }

Here is the testing tool:

    import java.lang.reflect.*;

    public class RunTests {
       public static void main(String[] args) throws Exception {
          int passed = 0, failed = 0;
          for (Method m : Class.forName(args[0]).getMethods()) {
             if (m.isAnnotationPresent(Test.class)) {
                try {
                   m.invoke(null);
                   passed++;
                } catch (Throwable ex) {
                   System.out.printf("Test %s failed: %s %n", m, ex.getCause());
                   failed++;
                }
             }
          }
          System.out.printf("Passed: %d, Failed %d%n", passed, failed);
       }
    }

    $ java RunTests Foo
    Test public static void Foo.m3() failed: java.lang.RuntimeException: Boom 
    Test public static void Foo.m7() failed: java.lang.RuntimeException: Crash 
    Passed: 2, Failed 2

package com.bjinfotech.practice.annotation;

/**
 * 演示如何使用java5内建的annotation
 * 参考资料：
 * http://java.sun.com/docs/books/tutorial/java/javaOO/annotations.html
 * http://java.sun.com/j2se/1.5.0/docs/guide/language/annotations.html
 * http://mindprod.com/jgloss/annotations.html
 * @author cleverpig
 *
 */
import java.util.List;

public class UsingBuiltInAnnotation {
        //食物类
        class Food{}
        //干草类
        class Hay extends Food{}
        //动物类
        class Animal{
                Food getFood(){
                        return null;
                }
                //使用Annotation声明Deprecated方法
                @Deprecated
                void deprecatedMethod(){
                }
        }
        //马类-继承动物类
        class Horse extends Animal{
                //使用Annotation声明覆盖方法
                @Override
                Hay getFood(){
                        return new Hay();
                }
                //使用Annotation声明禁止警告
                @SuppressWarnings({"deprecation","unchecked"})
                void callDeprecatedMethod(List horseGroup){
                        Animal an=new Animal();
                        an.deprecatedMethod();
                        horseGroup.add(an);
                }
        }
}

package com.bjinfotech.practice.annotation;

import java.lang.annotation.*;
/**
 * 定义annotation
 * @author cleverpig
 *
 */
//加载在VM中，在运行时进行映射
@Retention(RetentionPolicy.RUNTIME)
//限定此annotation只能标示方法
@Target(ElementType.METHOD)
public @interface AnnotationDefineForTestFunction{}

package com.bjinfotech.practice.annotation;

import java.lang.reflect.*;

/**
 * 一个实例程序应用前面定义的Annotation：AnnotationDefineForTestFunction
 * @author cleverpig
 *
 */
public class UsingAnnotation {
        @AnnotationDefineForTestFunction public static void method01(){}
        
        public static void method02(){}
        
        @AnnotationDefineForTestFunction public static void method03(){
                throw new RuntimeException("method03");
        }
        
        public static void method04(){
                throw new RuntimeException("method04");
        }
        
        public static void main(String[] argv) throws Exception{
                int passed = 0, failed = 0;
                //被检测的类名
                String className="com.bjinfotech.practice.annotation.UsingAnnotation";
                //逐个检查此类的方法，当其方法使用annotation声明时调用此方法
            for (Method m : Class.forName(className).getMethods()) {
               if (m.isAnnotationPresent(AnnotationDefineForTestFunction.class)) {
                  try {
                     m.invoke(null);
                     passed++;
                  } catch (Throwable ex) {
                     System.out.printf("测试 %s 失败: %s %n", m, ex.getCause());
                     failed++;
                  }
               }
            }
            System.out.printf("测试结果： 通过: %d, 失败： %d%n", passed, failed);
        }
}

当铲进井里的泥土落在驴子的背部时，
驴子的反应令人称奇──它将泥土抖落在一旁，然后站到铲进的泥土堆上面
就这样，驴子将大家铲倒在它身上的泥土全数抖落在井底，然后再站上去。
很快地，这只驴子便得意地上升到井口，
然后在众人惊讶的表情中快步地跑开了！

就如驴子的情况，在生命的旅程中，有时候我们难免会陷入「枯井」里，
会被各式各样的「泥沙」倾倒在我们身上，
而想要从这些「枯井」脱困的秘诀就是：将「泥沙」抖落掉，然后站到上去！
事实上，我们在生活中所遭遇的种种困难挫折就是加诸在我们身上的「泥沙」；
然而，换个角度看，它们也是一块块的垫脚石，
只要我们锲而不舍地将它们抖落掉，然后站上去，
那么即使是掉落到最深的井，我们也能安然地脱困。
本来看似要活埋驴子的举动，由于驴子处理厄境的态度不同，
实际上却帮助了它，这也是改变命运的要素之一。
如果我们以肯定、沉着稳重的态度面对困境，助力往往就潜藏在困境中。
一切都决定于我们自己，学习放下一切得失，勇往直前迈向理想。
我们应该不断地建立信心、希望和无条件的爱， 这些都是帮助我们从生命中的枯井脱困并找到自己的工具。

请牢记以下五个快乐的小秘诀：
1. 不要存有憎恨的念头。
2. 不要让忧虑沾染你的心。
3. 简单地生活。
4. 多分享。
5. 少欲求。

这边出来两个解释名词，我尽量不讲名词，是因为我不太喜欢讲理论，但是碰到名词还是提一下。其实我们中国祖先很早早就知道这个道理，只不过西洋人把他提炼炼出来以后，一动就用了他们的专业名字。

X和Y加起来是Z，我们是这样做的，X是集权的意思，集权的管理，这个集权，不是政治上的集权。就是说，真正的一把抓。在中国人寿可不可能有一种手下，讨厌做事情，逃避责任，不喜欢用脑筋，有的，一定有这两个人。

这时候你就像牧羊犬那样带着他，底下的人都是牲口，你把他带起来好了，你不管那些猪、牛、羊、马是什么想法，反正统统都是逃避责任，不喜欢动脑筋，你就把他带起来。但是你认为中国人寿，每个人都是这样吗？

不可能，第二种就出来了，叫做Y理论，Y理论，我们叫做参与管理。一个部下成熟以后，你就应该让他参与。每天在那里动脑筋想问题。真正如果有这种手下，两个加起来等于Z。其实中国人寿并不是全部都用X来管的，也不是全部用Y来管的，因为这两种人其实统统都有。

我们讲到Y，有没有人喜欢接受任务呢？怎么会没有呢？中国未来的主席假如是***，那么未来的总理是谁？不知道？假设我们***总理把我们上海市委**给找去了，我说王兄啊，我年纪大了，准备要退休了，这个位置让你来坐一坐，你看怎么样？你认为**会怎么讲？

NO！NO！总理不行，我这个人只能管一个上海，管到嘉定已经很勉强了，一管到昆山我就完了，一超过昆山就一塌糊涂，我的能力仅限于上海，他会这样讲话吗？不会。他会说：谢谢总理的抬爱，你看什么时候上班啊？

这就证明，人喜欢任务，没有人不喜欢任务，问题是给他的条件够不够？**先生知道，到了中央，他的权利是很大的。如果真的一点权利都没有，你看他会不会愿意去？

所以同样的市长，天津市就不行。天津市长听说凡事向***汇报，结果天津市弄得现在这个样子。结果天津现在传出一句风凉话，***这个市长，把一个直辖市管得县城一样。就是这样来的，你要去过天津就知道了，可惜这个地方。

我其实三年前到北京和天津我就发现这个现象，那时我在北京碰到几个高阶层的人，其实天津和北京两个直辖市靠得这么近，干脆合并算了。人家都说天津离皇上太近，所以皇上给他一种压迫。其实真正的理由是这个理由吗？天津有条海河，我们上海也有条苏州河，天津有个海安公路，我们上海有个外滩，其实是一样的。

民国初年的天津，比北京还繁荣，记得吗？那时候买泊来品还要天津去，外国领事馆都在天津。袁世凯还住过天津，傅仪都住过。所以今天闹成这个样子，说穿了就是管理人员的问题。

我结果讲了讲，北京笑一笑，没想到今天传出新的消息，叫做大北京计划，果然不错，英雄所见略同，大家的想法都一样的。大北京计划出来了，涵盖天津，所以北京不好意思把天津这个名字取掉，但是现在北京开始管天津了。

从明年开始，大北京计划开始了，北京的高速公路，北京的地下铁，现在开始要向天津通了，这就证明北京现在要把天津涵盖起来。不这个样子，那个天津永远变成一个县城。

那么什么叫中和，是这样做的。我们不可以凡事都讲物质，认为给人民币就可以了，其实我们还要注意精神。我们不能够一动就惩罚，其实我们还要讲激励。我不能一动就把制度搬出来吓人家，其实我们还要重视人心。这些地方非常重要，给人民币这个谁都会用，一动就研究奖金，请问精神面你是否注意到？

我读过一篇文章，说中国的企业，右边这三个还做得不够，就是说不太注意人性管理吧！讲到人性，我提醒各位，人性跟人情是两个意思。噢！我圈一个就讲一个，我们光讲物质，却没有注意到精神。那么我来讲一个精神上有关的事情。什么东西是一种精神面？

在宋朝的时候有一个老妈妈，跟他的邻居说，我那个老三在一个将军的底下打仗受了伤，将军亲自跪在地下替他扎伤口，说着，她就哭起来。很感动是不是？

她说不是的，我的老大原来也在他底下，一受伤，将军一跪在地上替他包扎伤口，他就报销了，打仗奋勇的杀敌，他就很快报销了。后来我那个老二又去，又受伤，也是这样包扎的，也报销了。现在完了，我那个仅存的老三，看样子也快报销了。

这叫做精神面。如果你下次受了小伤，如果我们单总亲自给你包扎伤口，你很快就报销了。对不对？你含着眼泪，快报销了。你回家给你老婆说，快报销了，这个伤口是我们单总给包扎的。请问，这样子要花多少人民币？不要花多少人民币嘛，这种观念，叫做精神面，其实我们做得不太够。

第二个，惩罚谁都会啊！要记过，要调职，要冷冻还不容易？问题是你激励他吗？激励。我有两次在摩托罗拉，他们的副总带我去参观他们的厂房，一个老美，走进去的时候看到一个中国员工在那里拧汗，男的，他走到旁边说，好孩子。

结果他又跟我走到后面去了，一个女的在那里做瓶管检验，他又说NICE GIRL！那个女的也笑一笑，他就跟我出去了。其实摩托罗拉那个老美，跟他底下那两个中间差9级，9层，请问他为什么这样讲？这个叫做激励。

我后来发现，西洋人非常注意这一点。因为我们当主管的，每天都快太忙了，不相信我请教你们一个问题，你们每天这么忙的时候，每天花几分钟，下去看看你们干部？你每天花几分钟，在办化验室里面走一圈？你干部送上来的那报告，你有没有先称赞再修改？当人家给你一个提议，你有没有先鼓励，然后指出他的盲点？

我们都是激励不足，一动就训，一动就削，一动就拿命令出来唬！这个其实是缺少激励的。后来我才发现这个是要从小养成的，原来西方从小对他的子女就有激励，所以长大以后就养成这种激励的习惯！

人类学家达尔文，小的时候有一天是这样回去的，他爸一看就知道口袋里有什么东西啊！这边掏出来是只四脚蛇，这边掏出来是只金龟子。小心不要咬到腿了。不会的，长大以后成为人类学家。成功网

如果你的小宝是回来是这样子的？口袋里是什么东西啊？啊呀！啪一下，看你象个四脚蛇，赶快去读书！一天到晚玩蛇！这一打，打掉个人类学家，这就是没有激励。

去年有个女的来上海，专门研究非洲的猩猩珍古德，她在四岁的时候，有天下午不见，她妈妈到处找她。不见了，几乎都要到警察局报案了，黄昏的时候，那个家伙出现了，手上拿两个鸡蛋，一身鸡毛，头上还有点鸡屎，妈，我孵了一下午孵不出小鸡。原来躲到鸡笼里边。

她妈妈一看，啊呀！我的天那！赶快洗个澡，我们吃完饭研究一下鸡蛋是怎么孵的。吃完饭以后母女两个讲了半天也讲不清楚。她妈妈又不是动物学家。

第二天她妈妈亲自到学校里问老师，回来再告诉珍古德。那时候她才四岁，这种观念叫做激励。如果是你的女儿一个下午不见了，结果从鸡笼里出来了，啪嗒！一下子下去，她哭了，你笑了。这样子其实叫做没有激励。

第三个是人性。讲制度谁都会，将公司的制度搬出来谁都会，但是一旦要讲到人性，我们做得又有点欠缺。所谓人性，他的意思是这样的，从人的心里面去想、思考、观察一种行为。

那么回到我们刚才那个例子，三得利啤酒厂副厂长的那个爸爸死了，那个副厂长是个上海人，他的爸爸死了，三德利啤酒厂的老总得到消息，就到他家去看他，这个不稀奇啊！鞠躬安慰两句不稀奇，稀奇的是他跟他俩个站在一起，开始对客人鞠躬。

另外陆续还有很多的同事来慰问，三得利啤酒那个总经理跟中国的副总站在一起，一直鞠躬，一直谢谢，人家还以为他的爸爸死了。你猜那个副厂长跟我说了句什么话？他说，余先生我没有想到，这个总经理是这样来的，所以我这辈子大概要死在三得利了。

这就叫做人性，在人性面上激化你。所以日本三得利有个习惯，部属任何家里面如果有丧事，去的时候不要光是鞠躬，要跟他们的家属站在一起，对外人打礼，表示我们是一家人。这种就叫做人性。

我以上所讲的例子，从刚才所讲的三得利，跟我所讲的摩托罗拉，跟我所讲的宋朝将军的故事，哪一个需要花钱？这些跟钱都没有关系。统统是出于人的内心，这种观念统统叫做Y，所以我们的左边是X，这两个如果综合起来，就是X+Y=Z。

其实在我们中国人寿不可能统统讲X的，也不可能统统讲Y的，是看情况综合起来运用。如果我们过度地偏X，就是一种集权式的管理，但还不到过渡偏Y的时候，你就开始给他参与，也是个乱七八糟，所以我们要看看视情况而定。

一讲到视情况而定就会有另外一个概念，我们来看一看。你们已经认识的李光耀，新加坡的前总理，他现在已经变成资政了，现在国务院总理是胡作栋，李光耀其实是我们中国人的后裔，所以我拿他举例，是因为他不是一个真正的西方人，李光耀是广东梅县客家人的后裔，所以，其实他的父亲和祖父与中国人有深厚的渊源。

李光耀虽然从小新加坡长大，可是他受的教育都是儒家的教育和思想。长大以后送到英国剑桥读书，同时带着东西方的的思想，我觉得这种人是最厉害的。又受过中国儒家的熏陶，又到过西方见识过西方世界，就像邓小平一样，早年在中国长大，又看过欧洲，所以对邓小平的改革开放，跟他到过欧洲肯定很有关系。

李光耀管新加坡其实只有四个字，这四个字足以表达X与Y的理论，叫做开明专制。他讲得很有道理，管一个国家和一个社会，精神上面要以尽量的开明，精神可以开明，但是法律一定要专制。所以，新加坡就变成这样子了。其实他的开明就是X，他的专制就是Y，就是X和Y加起来。新加坡就变成这样子了，正好合乎这个道理。

所以精神上尽量开明，在中国人寿，我们采纳不同的意见，允许不同的声音，接受不同的策略，这个叫精神止非常开明。但是中国人寿对一些重要的规定，重要的要求，重要的制度，一定要非常坚持，这叫法令，就是法令要专制。成功网

精神要开明，其实要管新加坡就是这四个字，这本书其实出版的时候，我一夜之间就把它读完了，读到天亮，因为写得很好。这本书原文是英文的，后来翻成中文，在台湾出版，我想没有多久在大陆可以买得到翻译本。如果有一天在中国大陆出版，可以好好的读一读，管一个国家跟管一个公司是完全一样的，所以，读这个书好象在读企管一样，有道理。

    在探讨流媒体之前，我们不妨简要地回顾一下数字信息时代的数字化进程。众所周知，语音的数字化造就了数字程控交换机和蜂窝移动数字电话技术的发展；音频和视频的数字化又造就了计算机多媒体技术的发展；多种音视频流技术的演变又使得传统消费类音视频产品的数字化。而承载这种变化的便是语音流、音频流、视频流这样的媒体流，处理这些媒体流就需要高性能数字媒体技术。

    高性能的数字媒体技术覆盖的是一个广阔的流媒体和基于媒体的新兴技术，这便囊括了集成视频、语音、数据内容到许多新的和特色化的应用，并且重新构造数字媒体内容提供的方式。数字媒体所面临的挑战包含实时的性能，更高的信道密度和软件编程的灵活性，以适应同时出现的视频、语音、数据流的传输的需要。典型的数字媒体处理视功能包括编码、解码媒体流，不同格式的码转换，不同速率的流转换，以适应变化的系统级需求。另外还包括压缩、解压，加密、分组化和媒体流的传输等处理功能。

    流媒体其实是个技术名词，简单来说就是采用流技术，即把连续的影象和声音信息经过压缩处理，在网络上实施多媒体文件的实时传输和播放。由于宽带已成为网络架构的重点，流媒体的特点是如何运用可变带宽技术，使人们可以在灵活的带宽环境下在线欣赏高品质音频和视频节目，及至进行实时可视通信。既然流媒体可以适应各种不同网络带宽，在窄带下也同样可以流畅的观看、收听，当然，质量会因带宽的限制而略有影响。

    流媒体实现的关键技术是用流式传输，把声音、影像或动画等信息由音视频服务器向用户终端连续地实时传送。这种流式传输系统的多媒体文件经特定压缩方式被解析成压缩包，由视频服务器向用户终端顺序或实时传送，用户只需经过几秒的启动延时便可进行观看。在音频和视频等媒体文件在播放时，文件剩余部分将在后台从服务器内继续下载。

    流媒体技术包含着跨媒体融合的实用技术，其中必然涉及许多视频和音频标准的应用，其中不少标准尚需不断完善。这些标准的实现可以采用硬件或软件技术处理。对于成熟的标准，可以采用专用硬件，而对于不够成熟的标准，或是未确定国际化的标准，采用软件算法实现将更为可行，其最理想的处理平台就是高速数字信号处理器（DSP）。由于媒体流产品可进行本地解码，因此实际上消费者看不到其内容格式，而媒体流设备的固有功能性却能够得到进一步增强。如果在设计的中心位置具有一个可编程内核，原始设备制造商 (OEM) 就可通过简单的软件下载即可升级到新的或修订后的标准。DSP便可提供这样一个将所有这些功能结合起来的核心，OEM 厂商的流媒体产品设计因此而具有不断完善的灵活性以适应不断变化的技术要求。

    流媒体相关技术标准

    在流媒体技术中传输的多媒体数据需要预先进行特殊的压缩处理，那么针对不同的应用可以分为面向视频流、面向影像流、面向音频流和面向语音流四类，将对应不同的处理技术方法，于是就有一系列标准和规范。

    在视频流中包括侧重于交互应用的H.263，还有侧重于监控应用M-JPEG。至于 MPEG1和MPEG2已在激光影碟中广泛应用。MPEG4技术的应用将使当前很多提供声音和数据服务的系统得到进一步的扩展，其所具备的高压缩率和很强的编码容错功能必将使它在互联网和当前蜂窝通信网络的视频领域得到广泛应用。

    H.264是ITU在MPEG4基础上开发出来的新的视频编码算法，具有更高的编码效率、更强的解码差错恢复能力、以及提高了对移动通信和IP网络的适应性。H.264有可能作为MPEG-4的后继技术而成为一种适用于各类系统的公共技术，因此业界对它在下一代视频通信领域的应用前景普遍寄予厚望。中国在广阔的国内多媒体通信市场上占据主动，也在开发拥自主知识产权的AVS标准并已有重大进展。

    视频流在网络上实现播放时，媒体播放器需要识别媒体文件格式，并从中得到回放所需信息。因特网上使用较多的流式视频格式有RealNetworks公司所制定的音频视频压缩规范称为RealMedia，是一个跨平台的客户/服务器结构的多媒体应用标准。Apple计算机公司的QuickTime是数字媒体领域事实上的工业标准，可以通过网络提供实时的数字化信息流、工作流与文化回放功能。微软公司也正用将其专有的Windows Media技术应用于编解码市场。DivX在该领域也颇具影响力。

    除视频流之外，面向影像流的标准包括JPEG、GIFF、TIFF、位图等；面向音频的标准有AAC、 ATRAC3、 MP3、 WMA等；而面向语音的标准有AMR, G.723.1, G.726, G.711，G.722，G.728，G.729等。

    流媒体采用流式传输方式在网络服务器与客户端之间进行传输，流式传输的实现需要合适的传输协议。IETF（Internet Engineering Task Force，因特网工程任务组）制订的很多协议可用于实现流媒体技术。

    流媒体实用解决方案

    DSP以其高性能和软件可编程等特点，长期历来对数字媒体处理起到了积极的推动作用。TI在DSP媒体处理技术上积累丰富的经验，其解决方案的应用范围极为广泛，可以涵盖高性能视频到低成本音频与影像。随着DSP在实现SOC技术上的巨大进展，TI陆续推出一批基于DSP，适用于流媒体的的通用媒体处理器，并且全面支持各种的流媒体格式，以针对不用的产品应用方向。

    TMS320DA180是针对音频流的平台处理，是集成DSP和RISC处理器的双核结构，并具有包括以太网接口在内的多种外围接口，易于扩展WLAN。可以支持许多种音频和语音解码，适合于远程音频播放器和网络广播等产品。

    TMS320DM270是针对影像和视频流平台，不仅集成有DSP和RISC处理器的双核结构，为增强影像和视频处理能力，又集成有专用图像处理引擎iMX。该器件中还集成了CCD控制区、OSD视频编码器、影像预览等单元。DM270支持MPEG4在VGA分辨率下的实时解码，以及在CIF分辨率的实时编解码，适用产品为数字媒体播放器和视频电话、网络相机等。

    TMS320DM642 数字媒体处理器作为高端视频流平台，将在更多的视频和影像解决方案中扮演着重要的作用。基于经业届验证的C64x DSP核心，DM642是业界当今最高性能的多媒体引擎，具有方便地升级任何最新编解码软件的能力。DM642具有支持VGA分辨率下的单路MPEG2编码或四路MPEG2解码的能力。其有高质量、多通道、优越的视频性能，以及完整的软件可编程性，可加快视频产品的上市时间，通过集成音频可视性外设降低系统成本。DM642极其兼容优化器件DM641和DM640适用于VOD和IP机顶盒、数字媒体中心、数字监控系统等应用。

    为便于推广DSP的流媒体解决方案，TI已推出数字媒体开发套件，并在基于其DSP的平台上展示了对H.264基本和主类协议的编解码能力。TI一直与H.264软件算法开发商，如UBVideo和Ingenient技术公司合作。该综合开发套件不仅可以使视频工程师更加熟悉DSP，而且可以使DSP工程师更容易开发视频系统。

    众多知名的视频算法提供商如Emuzed、Escient、FedTec、iM Networks、Ingenient、Mediabolic 及 Oregon Networks等，已基于TI的媒体平台开发出商用流媒体方案。业界知名的嵌入式操作系统公司Accelerated Technologies、Pigeon Point Systems 及 WindRiver已经能够支持TI的流媒体解决方案，而 DivX、Microsoft、Quicktime 以及 RealNetworks 等多家公司的媒体编码译码器已移植到 TI 的媒体流产品中。

    以媒体处理平台支持流媒体技术, 并综合多种相关技术，以推广低成本、高性能的解决方案，是流媒体产品产业化的关键。期待着更多的媒体内容不仅由PC,而且由多种新型独具特色的视频媒体终端，通过流媒体技术传送到千家万户。

    流媒体的发展空间

    宽带入户的不断发展已使家庭网络技术成本已逐步达到消费者的心理价位。今天，有数以百万计的计算机用于存储音乐文件和来自数字相机的影像。个人视频收录机（PVR）和个人音频收录机（PAR）正在成为新的市场热点，并加速了流媒体技术的产业化进程。更多的设备需要使得消费者在数字家庭内外对多种媒体格式进行管理、储存、显示以及分配，便使得流媒体的解决方案拓展到数字电视、数字媒体中心、数字机顶盒、小区媒体网关，以及便携式手持终端等广阔的市场空间。

    Forrester Research公司调查表明，将数字家庭转变成大众市场的先决条件正逐渐形成：客户正在升级其外设；服务供应商提供的服务项目不仅仅限于访问；而家庭网络设备也正开始与所有设备进行无缝连接。Yankee Group公司提供的数据表明，美国近1,700万个家庭拥有宽带连接，其中有400万个家庭可经常下载完整的视频内容。流媒体技术由此而得到了发展的机遇。

    在中国，作为影响最广、增长最快、市场潜力最大的产业之一的互联网，正在以超出人们想象的深度和广度迅速的发展。根据CNNIC的报告，截止2003年底，中国网民数达到了7950万，居世界第二位；上网计算机达到3089万台，网络国际出口带宽总数达到27216M。数字家庭消费者的愿望主要集中于对现有或新的丰富的多媒体内容进行更好的管理。这种愿望为服务供应商、消费类电子与网络设备制造商提供了重大的商机，以便他们推出使用户可轻松访问内容的产品。因此，流媒体在中国的推广势在必行。

1.1 Hibernate API 变化
1.1.1 包名
1.1.2 org.hibernate.classic包
1.1.3 Hibernate所依赖的第三方软件包
1.1.4 异常模型
1.1.5 Session接口
1.1.6 createSQLQuery()
1.1.7 Lifecycle 和 Validatable 接口
1.1.8 Interceptor接口
1.1.9 UserType和CompositeUserType接口
1.1.10 FetchMode类
1.1.11 PersistentEnum类
1.1.12 对Blob 和Clob的支持
1.1.13 Hibernate中供扩展的API的变化
1.2 元数据的变化
1.2.1 检索策略
1.2.2 对象标识符的映射
1.2.3 集合映射
1.2.4 DTD
1.3 查询语句的变化
1.3.1 indices()和elements()函数

尽管Hibernate 3.0 与Hibernate2.1的源代码是不兼容的，但是当Hibernate开发小组在设计Hibernate3.0时，为简化升级Hibernate版本作了周到的考虑。对于现有的基于Hibernate2.1的Java项目，可以很方便的把它升级到Hibernate3.0。

本文描述了Hibernate3.0版本的新变化，Hibernate3.0版本的变化包括三个方面：
（1）API的变化，它将影响到Java程序代码。
（2）元数据，它将影响到对象-关系映射文件。
（3）HQL查询语句。

值得注意的是， Hibernate3.0并不会完全取代Hibernate2.1。在同一个应用程序中，允许Hibernate3.0和Hibernate2.1并存。

1.1 Hibernate API 变化

1.1.1 包名

Hibernate3.0的包的根路径为: “org.hibernate” ，而在Hibernate2.1中为“net.sf.hibernate”。这一命名变化使得Hibernate2.1和Hibernate3.0能够同时在同一个应用程序中运行。

如果希望把已有的应用升级到Hibernate3.0，那么升级的第一步是把Java源程序中的所有“net.sf.hibernate”替换为“org.hibernate”。

Hibernate2.1中的“net.sf.hibernate.expression”包被改名为“org.hibernate.criterion”。假如应用程序使用了Criteria API，那么在升级的过程中，必须把Java源程序中的所有“net.sf.hibernate.expression”替换为“org.hibernate.criterion”。

如果应用使用了除Hibernate以外的其他外部软件，而这个外部软件又引用了Hibernate的接口，那么在升级时必须十分小心。例如EHCache拥有自己的CacheProvider： net.sf.ehcache.hibernate.Provider，在这个类中引用了Hibernate2.1中的接口，在升级应用时，可以采用以下办法之一来升级EHCache:

（1）手工修改net.sf.ehcache.hibernate.Provider类，使它引用Hibernate3.0中的接口。
（2）等到EHCache软件本身升级为使用Hibernate3.0后，使用新的EHCache软件。
（3）使用Hibernate3.0中内置的CacheProvider：org.hibernate.cache.EhCacheProvider。

1.1.2 org.hibernate.classic包

Hibernate3.0把一些被废弃的接口都转移到org.hibernate.classic中。

1.1.3 Hibernate所依赖的第三方软件包

在Hibernate3.0的软件包的lib目录下的README.txt文件中，描述了Hibernate3.0所依赖的第三方软件包的变化。

1.1.4 异常模型

在Hibernate3.0中，HibernateException异常以及它的所有子类都继承了java.lang.RuntimeException。因此在编译时，编译器不会再检查HibernateException。

1.1.5 Session接口

在Hibernate3.0中，原来Hibernate2.1的Session接口中的有些基本方法也被废弃，但为了简化升级，这些方法依然是可用的，可以通过org.hibernate.classic.Session子接口来访问它们，例如：

org.hibernate.classic.Session session=sessionFactory.openSession();
session.delete("delete from Customer ");

在Hibernate3.0中，org.hibernate.classic.Session接口继承了org.hibernate.Session接口，在org.hibernate.classic.Session接口中包含了一系列被废弃的方法，如find()、interate()等。SessionFactory接口的openSession()方法返回org.hibernate.classic.Session类型的实例。如果希望在程序中完全使用Hibernate3.0，可以采用以下方式创建Session实例：

org.hibernate.Session session=sessionFactory.openSession();

如果是对已有的程序进行简单的升级，并且希望仍然调用Hibernate2.1中Session的一些接口，可以采用以下方式创建Session实例：

org.hibernate.classic.Session session=sessionFactory.openSession();

在Hibernate3.0中，Session接口中被废弃的方法包括：
* 执行查询的方法：find()、iterate()、filter()和delete(String hqlSelectQuery)
* saveOrUpdateCopy()

Hibernate3.0一律采用createQuery()方法来执行所有的查询语句，采用DELETE 查询语句来执行批量删除，采用merge()方法来替代 saveOrUpdateCopy()方法。

提示：在Hibernate2.1中，Session的delete()方法有几种重载形式，其中参数为HQL查询语句的delete()方法在Hibernate3.0中被废弃，而参数为Ojbect类型的的delete()方法依然被支持。delete(Object o)方法用于删除参数指定的对象，该方法支持级联删除。

Hibernate2.1没有对批量更新和批量删除提供很好的支持，参见<<精通Hibernate>>一书的第13章的13.1.1节（批量更新和批量删除），而Hibernate3.0对批量更新和批量删除提供了支持，能够直接执行批量更新或批量删除语句，无需把被更新或删除的对象先加载到内存中。以下是通过Hibernate3.0执行批量更新的程序代码：

Session session = sessionFactory.openSession();
Transaction tx = session.beginTransaction();

String hqlUpdate = "update Customer set name = :newName where name = :oldName";
int updatedEntities = s.createQuery( hqlUpdate )
.setString( "newName", newName )
.setString( "oldName", oldName )
.executeUpdate();
tx.commit();
session.close();

以下是通过Hibernate3.0执行批量删除的程序代码：

Session session = sessionFactory.openSession();
Transaction tx = session.beginTransaction();

String hqlDelete = "delete Customer where name = :oldName";
int deletedEntities = s.createQuery( hqlDelete )
.setString( "oldName", oldName )
.executeUpdate();
tx.commit();
session.close();

1.1.6 createSQLQuery()

在Hibernate3.0中，Session接口的createSQLQuery()方法被废弃，被移到org.hibernate.classic.Session接口中。Hibernate3.0采用新的SQLQuery接口来完成相同的功能。

1.1.7 Lifecycle 和 Validatable 接口

Lifecycle和Validatable 接口被废弃，并且被移到org.hibernate.classic包中。

1.1.8 Interceptor接口

在Interceptor 接口中加入了两个新的方法。 用户创建的Interceptor实现类在升级的过程中，需要为这两个新方法提供方法体为空的实现。此外，instantiate()方法的参数作了修改，isUnsaved()方法被改名为isTransient()。

1.1.9 UserType和CompositeUserType接口

在UserType和CompositeUserType接口中都加入了一些新的方法，这两个接口被移到org.hibernate.usertype包中，用户定义的UserType和CompositeUserType实现类必须实现这些新方法。

Hibernate3.0提供了ParameterizedType接口，用于更好的重用用户自定义的类型。

1.1.10 FetchMode类

FetchMode.LAZY 和 FetchMode.EAGER被废弃。取而代之的分别为FetchMode.SELECT 和FetchMode.JOIN。

1.1.11 PersistentEnum类

PersistentEnum被废弃并删除。已经存在的应用应该采用UserType来处理枚举类型。

1.1.12 对Blob 和Clob的支持

Hibernate对Blob和Clob实例进行了包装，使得那些拥有Blob或Clob类型的属性的类的实例可以被游离、序列化或反序列化，以及传递到merge()方法中。

1.1.13 Hibernate中供扩展的API的变化

org.hibernate.criterion、 org.hibernate.mapping、 org.hibernate.persister和org.hibernate.collection 包的结构和实现发生了重大的变化。多数基于Hibernate
2.1 的应用不依赖于这些包，因此不会被影响。如果你的应用扩展了这些包中的类，那么必须非常小心的对受影响的程序代码进行升级。

1.2 元数据的变化

1.2.1 检索策略

在Hibernate2.1中，lazy属性的默认值为“false”，而在Hibernate3.0中，lazy属性的默认值为“true”。在升级映射文件时，如果原来的映射文件中的有关元素，如<set>、<class>等没有显式设置lazy属性，那么必须把它们都显式的设置为lazy=“true”。如果觉得这种升级方式很麻烦，可以采取另一简单的升级方式：在<hibernate-mapping>元素中设置: default-lazy=“false”。

1.2.2 对象标识符的映射

unsaved-value属性是可选的，在多数情况下，Hibernate3.0将把unsaved-value="0" 作为默认值。

在Hibernate3.0中，当使用自然主键和游离对象时，不再强迫实现Interceptor.isUnsaved()方法。 如果没有设置这个方法，当Hibernate3.0无法区分对象的状态时，会查询数据库，来判断这个对象到底是临时对象，还是游离对象。不过，显式的使用Interceptor.isUnsaved()方法会获得更好的性能，因为这可以减少Hibernate直接访问数据库的次数。

1.2.3 集合映射

<index>元素在某些情况下被<list-index>和<map-key>元素替代。此外，Hibernate3.0用<map-key-many-to-many> 元素来替代原来的<key-many-to-many>.元素，用<composite-map-key>元素来替代原来的<composite-index>元素。

1.2.4 DTD

对象-关系映射文件中的DTD文档，由原来的：
http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd
改为：
http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd

1.3 查询语句的变化

Hibernate3.0 采用新的基于ANTLR的HQL/SQL查询翻译器，不过，Hibernate2.1的查询翻译器也依然存在。在Hibernate的配置文件中，hibernate.query.factory_class属性用来选择查询翻译器。例如：
（1）选择Hibernate3.0的查询翻译器：
hibernate.query.factory_class= org.hibernate.hql.ast.ASTQueryTranslatorFactory
（2）选择Hibernate2.1的查询翻译器
hibernate.query.factory_class= org.hibernate.hql.classic.ClassicQueryTranslatorFactory

提示：ANTLR是用纯Java语言编写出来的一个编译工具，它可生成Java语言或者是C++的词法和语法分析器，并可产生语法分析树并对该树进行遍历。ANTLR由于是纯Java的，因此可以安装在任意平台上，但是需要JDK的支持。

Hibernate开发小组尽力保证Hibernate3.0的查询翻译器能够支持Hibernate2.1的所有查询语句。不过，对于许多已经存在的应用，在升级过程中，也不妨仍然使用Hibernate2.1的查询翻译器。
值得注意的是， Hibernate3.0的查询翻译器存在一个Bug：不支持某些theta-style连结查询方言：如Oracle8i的OracleDialect方言、Sybase11Dialect。解决这一问题的办法有两种：（1）改为使用支持ANSI-style连结查询的方言，如 Oracle9Dialect,（2）如果升级的时候遇到这一问题，那么还是改为使用Hibernate2.1的查询翻译器。

1.3.1 indices()和elements()函数

在HQL的select子句中废弃了indices()和elements()函数，因为这两个函数的语法很让用户费解，可以用显式的连接查询语句来替代 select elements(...) 。而在HQL的where子句中，仍然可以使用elements()函数。