编程术语方面的请教，长期请教，还请各位指点

ztchen

我英语基础比较一般，现在正在琢磨如果来澳洲Coding方面势必要把英语作为母语，虽然那是我一直向往的，也是非常有利于编程，毕竟不能把代码注释或开发文档都用中文写给鬼佬当天书看。所以需要改进习惯从现在开始就逐步用英语来写，尤其是在专业术语方面。最近一直在努力坚持把现在工作中常用的如注释、开发文档、工作记录等用英语写，但拼凑了半天始终有闭门造车之感，更恐惧的是周围的同事都说能够看明白。。。非常怕我这样勤奋结果却写成只有华人才看得懂的中国式英文。所以发此帖想长期请教这边的同行，看看我自己组织的英语是否能与国际接轨，也为明年融入澳洲能够打下基础，还望各位多指点，在下不胜感激，谢谢！


先问个注释的问题，代码如下：

       /// <summary>
        ///Constructer, create instance of the object which is used as default-mode by the SQLServerDB-type.
        /// </summary>
        public College()
        {
            dal = DataAccess.CreateCollege(DBType.Sqldb);
        }

请问标出的绿色注释部分的意思大家能理解么？

ztchen

up

luyangcy

构造函数，创建被SQLServerDB-type.用作缺省模式的对象的一个实例。

还行，能表达出意思

大饼

原帖由 luyangcy 于 2007-11-20 08:51 发表
构造函数，创建被SQLServerDB-type.用作缺省模式的对象的一个实例。

还行，能表达出意思

完全
现在还能看懂，不过再继续写汇编和C，以后再碰到C++, C#就要

月亮

中国人看中国人的英语总是能看懂得，因为思维方式一致，
最好的办法是多看鬼佬写的东西，慢慢就能融会贯通了

lee3star

学java呢？不错，有钱途

bc

Constructer should be Constructor

伐木者

You don't have to tell a programmer that a constructor is used to create object instances.

ztchen

谢谢大家，继续努力。

Constructer->Constructor，这个纠正。

鬼佬的代码从来没有看过，希望有机会能够看看，呵呵

楼上的朋友啊，我是C#，不是Java，不知道前途如何？

ztchen

原帖由 伐木者 于 2007-11-20 09:55 发表
You don't have to tell a programmer that a constructor is used to create object instances.

您说得对，我的意思可能表达得有点不够详细，其实我这里的object是指一个模块级变量dal，在构造函数里new了该对象的一个实例。

伐木者

原帖由 ztchen 于 2007-11-20 12:23 发表


您说得对，我的意思可能表达得有点不够详细，其实我这里的object是指一个模块级变量dal，在构造函数里new了该对象的一个实例。

That's really implementation details and you don't want to put these kind of comments against constructor/method.

[ 本帖最后由 伐木者 于 2007-11-20 13:41 编辑 ]

flyspirit

这段代码不是普通意义上的构造函数。而是通过singleton产生一个instance

伐木者

原帖由 flyspirit 于 2007-11-20 14:02 发表
这段代码不是普通意义上的构造函数。而是通过singleton产生一个instance

What instance are you creating?

gozh2005

而是通过singleton产生一个instance

In that case..you constructor woun't be public...

伐木者

原帖由 gozh2005 于 2007-11-20 16:23 发表
而是通过singleton产生一个instance

In that case..you constructor woun't be public...

I don't think the author intended to make the College class singleton.

ztchen

原帖由 伐木者 于 2007-11-20 13:39 发表


That's really implementation details and you don't want to put these kind of comments against constructor/method.

ok , I usual put the summary of method against the method and put the details in the code line.

ztchen

原帖由 flyspirit 于 2007-11-20 14:02 发表
这段代码不是普通意义上的构造函数。而是通过singleton产生一个instance

Excuse me, what  the singleton means?
I think I only want to use the constructor to create the variable of 'dal' which return the instance of the dataaccess way for SQLServer database and it is the default-mode.

ztchen

原帖由 gozh2005 于 2007-11-20 16:23 发表
而是通过singleton产生一个instance

In that case..you constructor woun't be public...

Why woun't be public? What it means?,thanks.

gozh2005

singleton means you will only have exactly one instance for that class type.

So usually the class will be like

public class Singleton
{
    Singleton() {}
    Public static Singleton Instance = new Singleton;
}

because the constructor is a private or protected, no client can really create a new instance then. the only way to access it will be Singleton.Instance.. and it is static and only one...

You better take a look at "Design Patterns", because not like two years ago, many times now the interview will ask about design patterns..

ztchen

Thank you very much. I understood it and your answers are very usefully for me.  But  in my code, it's not  used by the pattern of Singleton.
Actually, I  have read the 'Design Patterns'  many times , but always forgot something which was used seldom, very enjoy to learning from you!

还请大家请看看我上面表达的可否理解？谢谢！

ztchen

再发个让大家帮忙看一下，属性说明及属性名称是否可以被理解，如下：  

        /// <summary>
        /// Get or Set is activated flag.
        /// </summary>
        public bool IsActivated
        {
            get
            {
                return _IsActivated;
            }
            set
            {
                _IsActivated = value;
            }
        }

kenadams001

原帖由 ztchen 于 2007-11-23 01:31 发表
Thank you very much. I understood it and your answers are very usefully for me.  But  in my code, it's not  used by the pattern of Singleton.
Actually, I  have read the 'Design Patterns'  many ti ...

建议楼主随便找一些开源软件，一般代码里的注释都是很不错的。在任何代码里都可能用到singleton，比如创建抽象工厂的实例。可以看看head first design pattern，比design pattern更通俗易懂，而且你可以在里面找到很多非常好的注释。

flyspirit

Sorry,各位，我singleton的说法不太对，其实我是一眼看到DataAccess.CreateCollege(DBType.Sqldb);这句，就主观以为是singleton了   CreateXX, getintance此类名字的函数我常遇到是用来做singleton，当然CreateXX更像工厂

四人帮写的"Design Pattern"是很痛苦的事情。有人曾经给我推荐过"Java和模式“这本书，说很不错。不过模式的东西只有经常用了才有体会。如果编程的时间长了，很多模式已经有意无意的用过了，

ztchen

原帖由 kenadams001 于 2007-11-25 18:35 发表


建议楼主随便找一些开源软件，一般代码里的注释都是很不错的。在任何代码里都可能用到singleton，比如创建抽象工厂的实例。可以看看head first design pattern，比design pattern更通俗易懂，而且你可以在里面 ...

恩，非常感谢你的回答。This is a good way. 我现也是主要以英语学习为主，但如能和各位一起学习技术，那更是好事。

楼上说得对，设计模式其实感觉都是好理解的，但我觉得从来不太特意定性为什么模式，因为在实际中要灵活运用就未必能生搬硬套，各个模式之间也不会有完全的界定准则。

呵呵，不知道什么时候我能够把上面的观点也用英文表达出来就好了，这方面真的还望大家以后多指教，谢谢！

[ 本帖最后由 ztchen 于 2007-11-26 21:36 编辑 ]

flyspirit

看开源代码能够提高编程水平，但我不认为可以提高英语水平（仅指计算机方面)

看看原版英文编程书, 如果看这些书没有问题后，进一步可以看技术标准，比如RFC的文铛，w3c的文档等等。这能够看懂，基本上就没有问题了。

另外，别指望你的英文写出来能够和老外一样好，那不现实。周围同事能够看懂你的英文文档，没什么太大不了的，他们也有英语基础的

ztchen

恩，楼上说得对的。我目前还在国内，没有英语的环境，所以就希望在这里能够先在大家的指点下逐步锻炼。编程语言是世界语言，从语言本身中就能交流，但目前随着项目规模越来越大，不可能完全阅读代码，所以我想在开发文档等的交流方面也能够用英语表达，让已在澳洲的同行看看是否都能理解，而不是我国内的同事或者我能够理解的中国式英语。这样就能够提高至少在工作方面的适应能力，所以非常希望得到大家的支持，技术上也可以多交流。

顺便说一下，我在国内有6年汽车维修和7年软件开发的经验，这两方面技术的问题大家都可以交流，尤其是汽车维修，大家有什么问题可以问我，希望能给大家一些帮助。

jl162401

你真是强啊，我看注释这东西，只要大家看的明白就好，最简单的英文越好。

我们公司的那帮家伙经常写点西班牙文在注释上面，自娱自乐的。

说句心里话，你写的注释如果太detail，估计也没有人愿意去细看。大方面描述清楚即可。

ztchen

恩，应该也不会很繁琐，只要能够表达coding的意图和算法，方便阅读就可以了。我已经习惯先写注释，把思路和流程整理好再写代码实现的。我视coding为艺术，自然也就非常注重注释了。

jl162401

看来你要为艺术而献身了，我很尊敬这样的人，加油！

ztchen

麻烦大家帮我再看下，我下面的注释是否表达得对？
                  

                    // Get the college's branchs.
                    aryBranchInfos = ws.GetBranchsBycollegeId(collegeInfo.CollegeId);

                    // Get the branch's studentclasses.
                    aryStudentClassInfos = ws.GetStudentClassesBycollegeId(collegeInfo.CollegeId);

                    // Loop the array of the objects of branch and add the children nodes of the root node.
                    for (int i = 0; i < aryBranchInfos.Length; i++)
                    {
                        // Set the child node key to branchId.
                        TreeNode nodeBranch = new TreeNode();
                        BranchInfo branch = aryBranchInfos;
                        nodeBranch.Name = branch.BranchId;
                        nodeBranch.Text = branch.BranchName;
                        nodeCollege.Nodes.Add(nodeBranch);


                        if (aryStudentClassInfos.Length > 0)
                        {

                            // First of all, add the child nodes of studenttype with each college node.
                            for (int j = 0; j < aryStudentClassInfos.Length; j++)
                            {
                                // In this place, the studenttype key is composed by branchId and studenttypeId.
                                string strStudentTypeNodeKey = aryBranchInfos.BranchId + aryStudentClassInfos[j].StudentType.TypeId;

                                if (!tvwLeft.Nodes.ContainsKey(strStudentTypeNodeKey))
                                {
                                    TreeNode nodeStudentType = new TreeNode();
                                    nodeStudentType.Name = strStudentTypeNodeKey;
                                    nodeStudentType.Text = aryStudentClassInfos[j].StudentType.TypeName;
                                    nodeBranch.Nodes.Add(nodeStudentType);
                                }

                            }


                            // And then , add the child nodes of gradeseason with each studenttype node.                        
                           ...

                         }
                    }