07 January 2007

CakePHP 应用程序的数据流小结 · Summary of Data Flow in CakePHP Web Application



1. Controllers fetch data in database through Models, and set to vars which are available in Views.
1. Controllers(控制类) 通过 Models(模型类) 取得数据库的数据, 并赋给 Views 中能看到的变量。

2. Controllers accept data from Webpages through vars such as 'params'.
2. Controllers(控制类) 使用变量如 'params', 接受网页的数据。

3. Data in Sessions would be handled by Session vars.
3. 会话(Session)中的数据有专门的会话变量来处理。

4. Views call renderElement() to display repeatable Element files (i.e. mini-views) and pass parameters.
4. Views(视图类) 调用 renderElement() 来显示可重复用的 Element(元素) 文件 (即: 迷你视图) 并传递参数。

5. render() is automatically called at the end of each controller action to render its View. But redirect() and flash() is used for redirection.
5. 控制类的每个动作结束时能自动调用 render() 来递送 Views。而 redirect() 和 flash() 可用来转向。

6. There are many special functions and variables in Controllers.
6. 控制类中还有一些专门的函数和变量。

17 December 2006

A Survey of the JavaScript Programming Language


Douglas Crockford 重点翻译: Sheldon 于 2006 春
www.crockford.com

© 2002 Douglas Crockford


Overview


This document is an introduction to the JavaScript Programming Language for professional programmers. It is a small language, so if you are familiar with other languages, then this won't be too demanding.


JavaScript is not Java. They are two very different languages. JavaScript is not a subset of Java. It is not interpreted Java. (Java is interpreted Java!) JavaScript shares C-family syntax with Java, but at a deeper level it shows greater similarity to the languages Scheme and Self JavaScript 与 Java 共享 C 语言家族的语法, 但从更深的层次来说它的语法更像 Scheme 和 Self (译者注: 虽然是重点翻译, 但已翻出原文的全部重要点, 且仅仅读中文部分, 意思也连贯, 读者如有 C 和 Java 的基础, 通过本文应该能快速上手 JavaScript). It is a small language, but it is also a suprisingly powerful and expressive language.You should take a look at it. You will find that it is not a toy language, but a full programming language with many distinctive properties.


JavaScript is a regular language which won't take much time to learn. It is better suited to some tasks, such as client programming, than Java is JavaScript 比 Java 更适合去完成某些事,比如客户端编程. In my own practice, I have found that working with JavaScript has made me a better Java programmer because it introduced me to a useful set of dynamic techniques.


When JavaScript was first introduced, I dismissed it as being not worth my attention. Much later, I took another look at it and discovered that hidden in the browser was an excellent programming language. My initial attitudes were based on the initial positioning of JavaScript by Sun and Netscape. They made many misstatements about JavaScript in order to avoid positioning JavaScript as a competitor to Java. Those misstatements continue to echo in the scores of badly written JavaScript books aimed at the dummies and amateurs market.


History


JavaScript was developed by Brendan Eich at Netscape as the in-page scripting language for Navigator 2. It is a remarkably expressive dynamic programming language. Because of its linkage to web browsers, it instantly became massively popular. It never got a trial period in which it could be corrected and polished based on actual use. The language is powerful and flawed.


This document describes ECMAScript Edition 3 (aka JavaScript 1.5). Microsoft and Netscape are developing a static revision which does not correct the language's flaws. That new language is not JavaScript 译者注:好像是 JavaScript 2.0 还没出来,是基于类类型(class-based)的,而不像现在这样是基于原型(prototype-based)的 OO 语言 and is beyond the scope of this document.


Data Types


JavaScript contains a small set of data types. It has the three primitive types boolean, number, and string and the special values null and undefined 有三个(译者注:非对象)基本类型 boolean, number, and string 与特殊值 null (空/无效)undefined (无定义). Everything else is variations on the object type 其它都是 object (对象) (译者注:基本)类型的变化形式.


Boolean has two values: true and false.


Number is 64-bit floating point number 是 64 位的浮点数, similar to Java's double and Double. There is no integer type 没有 interger 类型. Division between two integers may produce a fractional result. Number also includes the special values NaN (not a number) and Infinity number 型还包括特殊值 NaN (无定义数值)Infinity (无穷大).


String is a sequence of zero or more Unicode characters. There is no separate character type 没有单独的字符类型. A character is represented as a string of length 1. Literal strings are quoted using the ' or " characters. The quote characters can be used interchangeably, but they have to match.


'This is a string.'

"Isn't this a string? Yes!"

'A' // The character A

"" // An empty string

Escapement is done with the \ character, like in Java. Strings are immutable. Strings have a length member String 有个 length 成员 which is used to determine the number of characters in the string.


var s = "Hello World!";
s.length == 12

译者注:三种简单类型像 Java 一样对应有三种包装对象。简单类型的字符串能调用 String 对象的成员方法,因为 JavaScript 在这过程中自动生成一个临时 String 对象。


It is possible to add methods to the simple types. So, for example, you can add an int() method to all numbers, so that Math.PI.int() produces 3.


An implementation may provide other types, such as Dates and Regular Expressions, but these are really just objects. Everything else is just objects. 好像实现了一些类型如 Date 和正则表达式 (译者注:这里指 RegExp),其实只是对象。其他也都只是对象。


Objects 译者注:JavaScript 的对象很有意思,不需要用 class 定义,因为是基于原型的,所有对象都是实例


JavaScript has very nice notational conveniences for manipulating hashtables.


var myHashtable = {};

This statement makes a new hashtable and assigns it to a new local variable 上述语句新产生了一个哈希表对象并赋值给一个新的局部变量. JavaScript is loosely typed, so we don't use type names in declarations JavaScript 是松类型语言,所以声明变量时没使用类型名. We use subscript notation to add, replace, or retrieve elements in the hashtable 我们用下标来添加替换访问哈希表元素.


myHashtable["name"] = "Carl Hollywood";

There is also a dot notation which is a little more convenient.


myHashtable.city = "Anytown";

The dot notation can be used when the subscript is a string constant in the form of a legal identifier. Because of an error in the language definition, reserved words cannot be used in the dot notation, but they can be used in the subscript notation.


You can see that JavaScript's hashtable notation is very similar to Java's object and array notations. JavaScript takes this much farther: objects and hashtables are the same thing, so I could have written JavaScript 的哈希表表示法很像 Java 的对象和数组表示法。JavaScript 甚至更进一步,对象和哈希表是相同的东西,于是上面的语句可替换成


var myHashtable = new Object();

and the result would have been exactly the same. 译者注:上面(事实上是整个这一节)说明了一般 object 对象的两种产生方法


There is an enumeration capability built into the for statement 语句 for 内置了枚举能力.


for (var n in myHashtable) {
document.writeln("<p>" + n + ": " + myHashtable[n] + "</p>");
}

The result will be 结果是


<p>name: Carl Hollywood</p>
<p>city: Anytown</p>

An object is a referenceable container of name/value pairs 一个对象是一个可引用(译者注:传值还是传引用,与 Java 处理相同。)的容器,内有一对对 名/值 对. The names are strings 其名是字符串(或数值索引) (or other elements such as numbers that are converted to strings). The values can be any of the data types, including other objects. Objects are usually implemented as hash-tables, but none of the hash-table nature (such as hash functions or rehashing methods) is visible.


Objects can easily be nested inside of other objects, and expressions can reach into the inner objects.


this.div = document.body.children[document.body.children.length - 1];

In the object literal notation, an object description is a set of comma-separated name/value pairs inside curly braces 一个字面对象的描述是花括弧以及在花括弧内一对对用逗号分开的名/值对. The names can be identifiers or strings followed by a colon 冒号. Because of an error in the language definition, reserved words cannot be used in the identifier form, but they can be used in the string form. The values can be literals or expressions of any type.


var myObject = {name: "Jack B. Nimble", 'goto': 'Jail', grade: 'A', level: 3};

return { //译者注:这里是新产生一个(匿名)对象,在函数定义中供返回
event: event,
op: event.type,
to: event.srcElement,
x: event.clientX + document.body.scrollLeft,
y: event.clientY + document.body.scrollTop
};

emptyObject = {};

New members can be added to any object at any time by
assignment 新的成员在任何时候可通过赋值添加进任何对象.


myObject.nickname = 'Jackie the Bee';

Arrays and functions are implemented as objects 数组和函数都实现为对象. 译者注:函数是对象有点让人吃惊, 如果只知道命令式语言而不知道函数式语言的话。


Arrays


Arrays in JavaScript are also hashtable objects. This makes them very well suited to sparse array applications. When you construct an array, you do not need to declare a size 不需要声明数组大小. Arrays grow automatically, much like Java vectors. The values are located by a key, not by an offset 分量值通过键而不是偏移量来确定. This makes JavaScript arrays very convenient to use, but not well suited for applications in numerical analysis.


The main difference between objects and arrays is the length property 数组和一般对象最大的不同是有一个 length 属性. The length property is always 1 larger than the largest integer key in the array 且其值总是比其数组最大的整数键的值大 1. There are two ways to make a new array 有两种方法产生新数组:


var myArray = [];
var myArray = new Array();

Arrays are not typed 数组没类型(译者注:暂且先理解成"元素不要求相同类型"). They can contain numbers, strings, booleans, objects, functions, and arrays. You can mix strings and numbers and objects in the same array 同一个数组内可混合字符串,数,对象. You can use arrays as general nested sequences, much as s-expressions. The first index in an array is usually zero.


When a new item is added to an array and the subscript is an integer that is larger than the current value of length, then the length is changed to the subscript plus one 新加入的分量如果其下标整数值大于数组的 length 数值,那么这 length 值就变成那个下标值加 1. This is a convenience feature that makes it easy to use a for loop to go through the elements of an array.


Arrays have a literal notation, similar to that for objects.


myList = ['oats', 'peas', 'beans', 'barley'];

emptyArray = [];

month_lengths = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];

slides = [
{url: 'slide0001.html', title: 'Looking Ahead'},
{url: 'slide0008.html', title: 'Forecast'},
{url: 'slide0021.html', title: 'Summary'}
];

A new item can be added to an array by assignment 通过赋值,新分量可以添加进数组.


a[i + j] = f(a[i], a[j]);

Functions


Functions in JavaScript look like C functions, except that they are declared with the function keyword instead of a type 但函数声明用关键字 function 而没有类型. When calling a function 函数调用时, it is not required that you pass a fixed number of parameters. Excess parameters are ignored. Missing parameters are given the value undefined 多余的参数会被忽略,而参数不够就设为(无定义) undefined. This makes it easy to write functions that deal with optional arguments.


A function has access to an arguments array. It contains all of the parameters that were actually sent by the caller. It makes it easy to deal with functions taking a variable number of arguments. For example,


function sum() {  // Take any number of parameters and return the sum
// 取不定多的参数并返回其和
var total = 0;
for (var i = 0; i < arguments.length; ++i) {
total += arguments[i];
}
return total;
}

JavaScript has inner functions, which serve the same purpose as inner classes in Java, but are much lighter JavaScript 有内部函数,作用相当于 Java 的内部类,但更轻巧. JavaScript also has anonymous functions, which act as lambda expressions JavaScript 还有匿名函数可用作 lambda 表达式. Functions have lexical scoping.


Functions are first class objects in JavaScript 函数在 JavaScript 中是顶级/头等对象. That means that they can be stored in objects and passed as arguments to functions.


Definition


There are three notations for defining functions 定义函数有三种表示法: function statement, function operator, and function constructor.


Function statement


The function statement creates a named function within the current scope.


function name(argumentlist) block


Functions can be nested. See Closures. An argumentlist is zero or more argument names, separated with commas. A block is a list of zero or more statements enclosed in { }.


The function statement is a shorthand for the function operator form 函数语句/声明定义法是函数运算符/表达式定义法的简写:


var name = function name(argumentlist) block ;


译者注:跟据下面的说明,函数扩展成能在运算表达式中定义,函数声明式可以看成特例,即在上述表达式中函数名和一个变量名相同。一般可以是
var var_name = function fun_name(argumentlist) block ;
(这同样说明函数也是对象),fun_name 只在函数体内可见,这不同于 var_name参阅


Function operator


The function operator is a prefix operator that produces a function object 这里 function 是个前缀运算符,(译者注:对参数作运算)产生函数对象. It looks similar to the function statement.


function name(argumentlist) block


The name is optional 这函数名 name 可省略. If it is provided, then it can be used by the function body to call itself recursively. It can also be used to access the function's object members (except on IE). If the name is omitted, then it is an anonymous function.


The function operator is commonly used to assign functions to a prototype.


The function operator can also be used to define functions in-place, which is handy when writing callbacks.


Function constructor


The function constructor takes strings containing the arguments and body, and produces a function object.


new Function(strings...) /*译者注:注意大写 F */


Do not use this form 别用这种 Function 构造式定义法的形式. The quoting conventions of the language make it very difficult to correctly express a function body as a string. In the string form, early error checking cannot be done. It is slow because the compiler must be invoked every time the constructor is called. And it is wasteful of memory because each function requires its own independent implementation.


Objects and this 对象及 this


A function is an object 一个函数是一个对象. It can contain members just as other objects. This allows an function to contain its own data tables. It also allows an object to act as a class, containing a constructor and a set of related methods 也允许一个对象起类型的作用,包含一个构造式和一套相关的方法.


A function can be a member of an object. When a function is a member of an object, it is called a method 函数成为对象的成员称为 方法. There is a special variable, called this that is set to the object when a method of the object is called.


For example, in the expression foo.bar(), the this variable is set to the object foo as a sort of extra argument for the function bar. The function bar can then refer to this to access the object of interest.


In a deeper expression like do.re.mi.fa(), the this variable is set to the object do.re.mi, not to the object do. In a simple function call, this is set to the Global Object (aka window), which is not very useful. The correct behavior should have been to preserve the current value of this, particularly when calling inner functions.


Constructor 自己定义 对象的构造式


Functions which are used to initialize objects are called constructors. (译者网上找来一张图供参考说明构造式定义,以及在继承定义中的使用。) The calling sequence for a constructor is slightly different than for ordinary functions. A constructor is called with the new prefix:


new Constructor(parameters...)


By convention, the name of a constructor is written with an initial capital.


The new prefix changes the meaning of the this variable. Instead of its usual value, this will be the new object. The body of the constructor function will usually initialize the object's members. The constructor will return the new object, unless explicitly overridden with the returnstatement.


The constructed object will contain a secret prototype link field, which contains a reference to the constructor's prototype member.


Prototype


Objects contain a hidden link property. This link points to the prototype member of the constructor of the object. 对象含有一个隐藏链接属性,链接到构造式的 prototype (原型) 成员。


When items are accessed from an object by the dot notation or the subscript notation, if the item is not found in the object then the link object is examined. If it is not found in the link object, and if the link object itself has a link object, then that link object is examined. If the chain of link objects is exhausted, then undefined is returned.


This use of prototype link chains provides a sort of inheritance.


Members can be added to the prototype by assignment. Here we define a new class Demo, which inherits from class Ancestor, and adds its own method foo 下面定义了一个新的"类" Demo,(原型变成新的对象)继承于"类" Ancestor,还 (译者注:用函数表达式定义法) 增加了成员方法 foo.


function Demo() {}
Demo.prototype = new Ancestor();
Demo.prototype.foo = function () {};

Vars


Named variables are defined with the var statement. When used inside of a function, var defines variables with function-scope. The vars are not accessible from outside of the function. There is no other granularity of scope in JavaScript. In particular, there is no block-scope 特别是没有块作用域.


Any variables used in a function which are not explicitly defined as var are assumed to belong to an outer scope, possibly to the Global Object 函数中没有用 var 定义的变量属于外层作用域,甚至是全局根对象(Global Object).


Vars which are not explicitly initialized are given the value undefined 没有明确初始化的变量值是 undefined.


Vars are not typed. A var can contain a reference to an object, or a string or a number or a boolean or null or undefined.


A new set of vars is made every time the function is called. This allows functions to be recursive.


Closure 闭包(译者注:嵌套的函数的局部变量及参数因为可见/作用域不同而形成的范围)


Functions can be defined inside of other functions. The inner function has access to the vars and parameters of the outer function. If a reference to an inner function survives (for example, as a callback function), the outer function's vars also survive.


Return


JavaScript does not have a void type, so every function must return a value. The default value is undefined, except for constructors, where the default return value is this. 因为没有 void 类型, 每个函数都有返回值,默认值是 undefined,除了构造式的默认值是 this


Statements


The set of named statements includes var, if, switch, for, while, do, break, continue, return, try, throw, and with. Most of them work the same as in other C-like languages.


The var statement is a list of one or more variables names, separated by commas, with optional initialization expressions.


var a, b = window.document.body;

If the var statement appears outside of any function, it adds members to the Global Object. If it appears inside of a function, it defines local variables of the function.


In if statements, while statements, do statements, and logical operators, JavaScript treats false, null, undefined, "" (the empty string), and the number 0 as false JavaScript 对待 false, null, undefined, "" (空字符串), 和数 0 为 false. All other values are treated as true.


The case labels in a switch statement can be expressions. They don't have to be constants. They can be strings.


There are two forms of the for statement. The first is the common (init; test; inc) form. The second is an object iterator.


for (name in object) {
value = object[name];
}

The block is executed for each name in the object. The order in which the names are produced is not guaranteed.


Statements can have a label prefix, which is an identifier followed with a colon.


The with statement should not be used.


Operators


JavaScript has a fairly large set of operators. Most of them work the same way as in other C-like languages. There are a few differences to watch out for.


The + operator is used for both addition and concatenation. If either of the operands is a string, it concatenates. This can cause errors. For example, '$' + 3 + 4 produces '$34', not '$7'.


+ can be used as a prefix operator, converting its string operand to a number.


!! can be used as a prefix operator, converting its operand to a boolean.


The && operator is commonly called logical and. It can also be called guard. If the first operand is false, null,undefined, "" (the empty string), or the number 0 then it returns the first operand. Otherwise, it returns the second operand. This provides a convenient way to write a null-check:


var value = p &amp;& p.name; /* The name value will
only be retrieved from p if p has a value, avoiding an error. */

The || operator is commonly called logical or. It can also be called default. If the first operand is false, null,undefined, "" (the empty string), or the number 0, then it returns the second operand. Otherwise, it returns the first operand. This provides a convenient way to specify default values:


value = v || 10; /* Use the value of v, but if v
doesn't have a value, use 10 instead. */

JavaScript supplies a set of bitwise and shift operators, but does not have an Integer type to apply them to. What happens is the Number operand (a 64-bit floating-point number) is converted to a 32-bit integer before the operation, and then converted back to floating point after the operation.


In JavaScript, void is a prefix operator, not a type. It always returns undefined. This has very little value JavaScript 的 void 是前缀运算符而不是类型,结果值是 undefined,很少用. I only mention it in case you accidently type void out of habit and are puzzled by the strange behavior.


The typeof operator returns a string based on the type of its operand.


Mistakes were made.








Object 'object'
Array 'object'
Function 'function'
String 'string'
Number 'number'
Boolean 'boolean'
null 'object'
undefined 'undefined'

Potpourri


Global Object


The Global Object is the keeper of all of the functions and variables which were not defined inside of other functions and objects. Surprisingly, the Global Object does not have an explicit name in the language Global Object 没有显式的名字. Sometimes the this variable points at it, but often not. In the web browsers, window and self are members of the Global Object which point to the Global Object Web 浏览器中用 Global Object 的成员 windowself 指向 Global Object, thus giving an indirect way of addressing it.


If a variable is accessed, but is not found in the current scope, it is looked for in the Global Object. If it is not found there, an error will result.


The ECMAScript specification does not talk about the possibility of multiple Global Objects, or contexts, but browsers support this ECMAScript 说明中没谈到多重 Global Object 或 Context 的可能性, 但浏览器有支持. Each window has its own Global Object 每个窗口有自己的 Global Object.


Semicolon Insertion


One of the mistakes in the language is semicolon insertion. This is a technique for making semicolons optional as statement terminators. It is reasonable for IDEs and shell programs to do semicolon insertion. It is not reasonable for the language definition to require compilers to do it. Use semicolons.


Reserved Words


JavaScript is very heavy handed in its restrictions on reserved words. The reserved words are


abstract
boolean break byte
case catch char class const continue
debugger default delete do double
else enum export extends
false final finally float for function
goto
if implements import in instanceof int interface
long
native new null
package private protected public
return
short static super switch synchronized
this throw throws transient true try typeof
var volatile void
while with

Most of those words are not even used in the language. A reserved word cannot be used

  1. As a name in literal object notation
  2. As a member name in dot notation
  3. As a function argument
  4. As a var
  5. As an unqualified global variable
  6. As a statement label

There is no excuse for the first two restrictions. None. There is an excuse for the second two restrictions, but it is very weak.

23 November 2006

软件中的英文翻译中文规则

(Rules of Translation to Chinese)



目的: 为了有高质量且统一的译文, 促进软件中文化。制定以下规则供参考。

要求: 以 "信达雅" 的标准来衡量。 "信" 诚信可信, 不宜翻译的保持引用原文; "达" 达意通顺, 但不能为了通顺而违反原意不可信; "雅" 是文学标准。


规则 1. 尽量使用英文的格式和标点, 除了使用中文的句号(。)和英文的双引号(" ")。

说明:

英文和中文的标点符号大多数是相同的, 尽量保留原标点能省时省力, 更何况中文的标点本就是引进的。 但使用中文的句号代替英文的句号, (不用中文的双引号) 用英文的双引号代替英文的单引号。因为英文软件中, 点(period)(.)和单引号(')有很多不同的意思。

例如: 文件名中的点号, 网址中的点号, 手册页(man page)中的格式是以点号起行, 等, 其实都是 dot。用中文的 "空心" 句号来断句有明显的优势。虽然有些科技文章用 "实心" 的。

再例如: 英文的单引号会被误认为英文的撇号(apostrophe), 在 (utf8 编码的) 显示中位置不对称; 中文的双/单引号也有左右之分, 对使用软件的替换工具, 把单引号替换成中文的引号是绝对不方便。而使用英文的双引号, 就能尽量减少显示和替换的麻烦。尽管英文的双引号和单引号在软件的字符串中, 既相互交叉使用, 也有自己的含义差别。

但在命令行字符串中引号不宜简单翻成中文的符号。建议此时保留英文的双引号; 而英文的单引号(')改中文的单引号(‘ ’), 同时尽量附加译者注释表示是 "英文" 的单引号。


规则 2. 按照传统的规则, 一个标点占一个中文字 (注: 一个中文字占两个字符), 但两个标点挤占一个中文字。 有时括号有例外情形。

说明:

既然使用英文的标点符号, 本来英文文章的标点符号后就有空格, 而中文的标点符号 (如: 句号) 一般占一个中文字。标点符号带的空格问题迎刃而解。用英文的符号和空格的另一个好处是: 字处理软件上往往是双击选取单词 (注: 英文是以英文的符号和空格来区分单词的), 碰到中文就不会选取整行了。(另外还有软件的字计数问题, 能不能计数智能一点啊。) 括号占位例外情形请参看下面的规则 2 中的建议。


规则 3. 碰到不宜翻译的词 (如: 专有名词, 术语, 翻不出来的词) 时, 应照顾读者的脑力而保留原文。

示例:

英文的撇号(apostrophe), 在 (utf8 编码的) 显示中位置不对称"

3.1. 只用原文时应保留前后的空格。如: 示例中的 "utf8"。

说明:

中英文夹杂一起时不留空格很费眼力不美观。而且几个英文词一起时, 为什么英文词是一个个的碰到中文就要粘在一起?

3.2. 同时用原文和译文 (硬要翻译的话) 建议用括号括起来。如: 示例中的 "apostrophe"。

说明:

不管是英文加带括号的中文译文, 还是中文加带括号的英文注释, 都可以, 取决于翻译者对哪个有把握。至于此时括号外面是否要带空格? 建议不带空格, 否则变成多出来的词了。不带空格的括号中的文字表示替换前面的词, 两者只读(取)其中一个。而带空格的括号中的文字应该不管读不读出来都要能保持整句通顺。但如果是几个英文词一起的加注释中文呢? 建议尽量避免, 要么注释整句, 这样可按照一般情形带空格。


规则 4. 阿拉伯数字当作英文, 前面用空格, 后面如果跟的是单位的话可用也可不用空格。


规则 5. 建议尽量弄个术语表和用语表, 对后继译者来说能统一翻译用词, 术语表对读者也是一种尊重。