Edit

クラス

概要

4D ランゲージでは クラス の概念がサポートされています。 プログラミング言語では、クラスを利用することによって、属性やメソッドなどを持つ特定のオブジェクト種を定義することができます。

クラスが定義されていれば、そのクラスのオブジェクトをコード内で インスタンス化 することができます。 各オブジェクトは、それ自身が属するクラスのインスタンスです。 クラスは、別のクラスを継承することで、それらの機能を受け継ぐことができます。

4D におけるクラスモデルは JavaScript のクラスに類似しており、プロトタイプチェーンに基づきます。

Class オブジェクト

クラスとは、それ自身が "Class" クラスのオブジェクトです。 Class オブジェクトは次のプロパティやメソッドを持ちます:

• name: ECMAScript に準拠している必要があります
• superclass オブジェクト (任意。無ければ null)
• new() メソッド: Class オブジェクトをインスタンス化します

さらに、Class オブジェクトは次を参照できます:

• constructor オブジェクト (任意)
• prototype オブジェクト: 名前付きのメソッドオブジェクトを格納します (任意)

Class オブジェクトは共有オブジェクトです。したがって、異なる 4D プロセスから同時にアクセスすることができます。

プロパティ検索とプロトタイプ

4D のすべてのオブジェクトは、なんらかの Class オブジェクトに内部的にリンクしています。 あるプロパティがオブジェクト内で見つからない場合、4D はそのクラスのプロトタイプオブジェクト内を検索します。見つからない場合、4D はそのクラスのスーパークラスのプロトタイプオブジェクト内を探します。これは、スーパークラスが存在しなくなるまで続きます。

すべてのオブジェクトは、継承ツリーの頂点である "Object" クラスを継承します。

  // クラス: Polygon
Class constructor
C_LONGINT($1;$2)
This.area:=$1*$2

 //C_OBJECT($poly)
C_BOOLEAN($instance)
$poly:=cs.Polygon.new(4;3)

$instance:=OB Instance of($poly;cs.Polygon)  
 // true
$instance:=OB Instance of($poly;4D.Object)
 // true 

オブジェクトのプロパティを列挙する際には、当該クラスのプロトタイプは列挙されません。 したがって、For each ステートメントや JSON Stringify コマンドは、クラスプロトタイプオブジェクトのプロパティを返しません。 クラスのプロトタイプオブジェクトプロパティは、内部的な隠れプロパティです。

クラス定義

ユーザークラスファイルによって、特定のオブジェクト種のひな形を定義します。new() クラスメンバーメソッドを呼び出すことで、このひな形に基づいたオブジェクトをインスタンス化することができます。 クラスファイル内では、専用の クラスキーワード や クラスコマンド を使用します。

たとえば:

// クラス: Person.4dm
Class constructor
  C_TEXT($1) // 名前
  C_TEXT($2) // 名字
  This.firstName:=$1
  This.lastName:=$2

この "Person" のインスタンスをメソッド内で作成するには、以下のように書けます:

C_OBJECT($o)
$o:=cs.Person.new("John";"Doe")  
// $o: {firstName: "John";lastName: "Doe" }

空のクラスファイルを作成し、空のオブジェクトをインスタンス化することも可能です。 たとえば、次の Empty.4dm クラスファイルを作成します:

// Empty.4dm クラスファイル
// 空です

メソッドでは次のように書けます:

$o:=cs.Empty.new()  
// $o : {}
$cName:=OB Class($o).name // "Empty"

クラスストア

定義されたクラスには、クラスストアよりアクセスすることができます。 クラスストアには次のものが存在します:

• ビルトイン 4Dクラス専用のクラスストア: 4D コマンドによって返されます。
• 開かれている各データベースおよびコンポーネントのクラスストア: cs コマンドによって返されます。 "ユーザークラス" ともいいます。

たとえば、cs.myClass.new() ステートメント (cs は クラスストア (classstore) を意味します) を使って myClass のオブジェクトインスタンスを新規作成できます。

ユーザークラス

クラスファイル

4D においてユーザークラスとは、/Project/Sources/Classes/ フォルダーに保存された専用のメソッドファイル (.4dm) によって定義されます。 ファイル名がクラス名になります。

たとえば、"Polygon" という名前のクラスを定義するには、次のファイルを作成する必要があります:

• データベースフォルダー
  • Project
    • Sources
      • クラス
        • Polygon.4dm

クラス名

クラスを命名する際には、次のルールに留意してください:

• ECMAScript に準拠した名前であること
• 大文字と小文字が区別されること
• 競合防止のため、データベースのテーブルと同じ名前のクラスを作成するのは推奨されないこと

4D 開発インターフェース

ファイル メニューまたはエクスプローラーなど、4D 開発インターフェースを介してクラスを作成した場合には、クラスファイルは自動的に適切な場所に保存されます。

ファイルメニューとツールバー

4D 開発の ファイル メニューまたはツールバーより 新規 > クラス... を選択することで、開いているプロジェクトにクラスファイルを新規作成することができます。

Ctrl+Shift+Alt+k ショートカットも使用できます。

エクスプローラー

エクスプローラーの メソッド ページにおいて、クラスは クラス カテゴリに分類されています。

クラスを新規作成するには次の方法があります:

• クラス カテゴリを選択し、 ボタンをクリックします。
• エクスプローラーウィンドウの下部にあるアクションメニュー、またはクラスグループのコンテキストメニューから 新規クラス... を選択します。
• エクスプローラーのホームページのコンテキストメニューより 新規 > クラス... を選択します。

クラスのコードサポート

各種 4D 開発ウィンドウ (コードエディター、コンパイラー、デバッガー、ランタイムエクスプローラー) において、クラスコードは "特殊なプロジェクトメソッド" のように扱われます:

• コードエディター:
  • クラスは実行できません
  • クラスメソッドはコードのブロックです
  • オブジェクトメンバーに対する 定義に移動 操作はクラスの Function 宣言を探します。例: "$o.f()" の場合、"Function f" を見つけます。
  • クラスのメソッド宣言に対する 参照箇所を検索 操作は、そのメソッドがオブジェクトメンバーとして使われている箇所を探します。例: "Function f" の場合 "$o.f()" を見つけます。
• ランタイムエクスプローラーおよびデバッガーにおいて、クラスメソッドは <ClassName> コンストラクターまたは <ClassName>.<FunctionName> 形式で表示されます。

クラスの削除

既存のクラスを削除するには:

• ディスク上で "Classes" フォルダーより .4dm クラスファイルを削除します。
• エクスプローラーでは、クラスを選択した状態で をクリックするか、コンテキストメニューより 移動 > ゴミ箱 を選択します。

クラスキーワード

クラス定義内では、専用の 4Dキーワードが使用できます:

• Function <Name>: オブジェクトのメンバーメソッドを定義します。
• Class constructor: オブジェクトのプロパティを定義します (プロトタイプ定義)。
• Class extends <ClassName>: 継承を定義します。

Function

シンタックス

Function <name>
// コード

クラス関数とは、当該クラスのプロトタイプオブジェクトのプロパティです。 また、クラス関数は "Function" クラスのオブジェクトでもあります。

クラス定義ファイルでは、Function キーワードと関数名を使用して宣言をおこないます。 このとき、メンバーメソッド名は ECMAScript に準拠している必要があります。

クラスメソッド内でオブジェクトインスタンスを参照するには This を使います。 たとえば:

Function getFullName
  C_TEXT($0)
  $0:=This.firstName+" "+Uppercase(This.lastName)

Function getAge
  C_LONGINT($0)
  $0:=(Current date-This.birthdate)/365.25

クラスメソッドの場合には、Current method name コマンドは次を返します: "<ClassName>.<FunctionName>" (例: "MyClass.myMethod")。

データベースのコード内では、クラスメソッドはオブジェクトインスタンスのメンバーメソッドとして呼び出され、引数を受け取ることができます。 次のシンタックスがサポートされています:

• () 演算子の使用 For example myObject.methodName("hello").
• use of a "Function" class member methods
  • apply()
  • call()

Thread-safety warning: If a class function is not thread-safe and called by a method with the "Can be run in preemptive process" attribute:

• the compiler does not generate any error (which is different compared to regular methods), - an error is thrown by 4D only at runtime.

Example

// Class: Rectangle
Class Constructor
    C_LONGINT($1;$2)
    This.name:="Rectangle"
    This.height:=$1
    This.width:=$2

// Function definition
Function getArea
    C_LONGINT($0)
    $0:=(This.height)*(This.width)

// In a project method
C_OBJECT($o)  
C_REAL($area)

$o:=cs.Rectangle.new()  
$area:=$o.getArea(50;100) //5000

Class constructor

Syntax

// Class: MyClass
Class Constructor
// code

A class constructor function, which can accept parameters, can be used to define a user class.

In that case, when you call the new() class member method, the class constructor is called with the parameters optionally passed to the new() function.

For a class constructor function, the Current method name command returns: "<ClassName>.constructor", for example "MyClass.constructor".

Example:

// Class: MyClass
// Class constructor of MyClass
Class Constructor
C_TEXT($1)
This.name:=$1

// In a project method
// You can instantiate an object
C_OBJECT($o)
$o:=cs.MyClass.new("HelloWorld")  
// $o = {"name":"HelloWorld"}

Class extends <ClassName>

Syntax

// Class: ChildClass
Class extends <ParentClass>

The Class extends keyword is used in class declaration to create a user class which is a child of another user class. The child class inherits all functions of the parent class.

Class extension must respect the following rules:

• A user class cannot extend a built-in class (except 4D.Object which is extended by default for user classes)
• A user class cannot extend a user class from another database or component.
• A user class cannot extend itself.
• It is not possible to extend classes in a circular way (i.e. "a" extends "b" that extends "a").

Breaking such a rule is not detected by the code editor or the interpreter, only the compiler and check syntax will throw an error in this case.

An extended class can call the constructor of its parent class using the Super command.

Example

This example creates a class called Square from a class called Polygon.

  //Class: Square
  //path: Classes/Square.4dm 

 Class extends Polygon

 Class constructor
 C_LONGINT($1)

  // It calls the parent class's constructor with lengths
  // provided for the Polygon's width and height
Super($1;$1)
  // In derived classes, Super must be called before you
  // can use 'This'
 This.name:="Square"

Function getArea
C_LONGINT($0)
$0:=This.height*This.width

Super

Super {( param{;...;paramN} )} {-> Object}

Parameter	Type		Description
param	mixed	->	Parameter(s) to pass to the parent constructor
Result	object	<-	Object's parent

The Super keyword allows calls to the superclass, i.e. the parent class.

Super serves two different purposes:

• inside a constructor code, Super is a command that allows to call the constructor of the superclass. コンストラクター内で使用する際には、Super コマンドは単独で使用され、また This キーワードよりも先に使用される必要があります。
  • If all class constructors in the inheritance tree are not properly called, error -10748 is generated. It's 4D developer to make sure calls are valid.
  • If the This command is called on an object whose superclasses have not been constructed, error -10743 is generated.
  • If Super is called out of an object scope, or on an object whose superclass constructor has already been called, error -10746 is generated.

  // inside myClass constructor
 C_TEXT($1;$2)
 Super($1) //calls superclass constructor with a text param
 This.param:=$2 // use second param

• inside a class member function, Super designates the prototype of the superclass and allows to call a function of the superclass hierarchy.

 Super.doSomething(42) //calls "doSomething" function  
    //declared in superclasses

Example 1

This example illustrates the use of Super in a class constructor. The command is called to avoid duplicating the constructor parts that are common between Rectangle and Square classes.

  //Class: Rectangle

 Class constructor
 C_LONGINT($1;$2)
 This.name:="Rectangle"
 This.height:=$1
 This.width:=$2

 Function sayName
 ALERT("Hi, I am a "+This.name+".")

 Function getArea
 C_LONGINT($0)
 $0:=This.height*This.width

  //Class: Square

 Class extends Rectangle

 Class constructor
 C_LONGINT($1)

  // It calls the parent class's constructor with lengths
  // provided for the Rectangle's width and height
 Super($1;$1)

  // In derived classes, Super must be called before you
  // can use 'This'
 This.name:="Square"

Example 2

This example illustrates the use of Super in a class member method. You created the Rectangle class with a function:

  //Class: Rectangle

 Function nbSides
 C_TEXT($0)
 $0:="I have 4 sides"

You also created the Square class with a function calling the superclass function:

  //Class: Square

 Class extends Rectangle

 Function description
 C_TEXT($0)
 $0:=Super.nbSides()+" which are all equal"

Then you can write in a project method:

 C_OBJECT($square)
 C_TEXT($message)
 $square:=cs.Square.new()
 $message:=$square.description() //I have 4 sides which are all equal

This

This -> Object

Parameter	Type		Description
Result	object	<-	Current object

The This keyword returns a reference to the currently processed object. This は、4Dにおいて 様々なコンテキスト で使用することができます。

This の値は、呼ばれ方によって決まります。 This の値は実行時に代入により設定することはできません。また、呼び出されるたびに違う値となりえます。

オブジェクトのメンバーメソッドとしてフォーミュラが呼び出された場合、This はメソッドの呼び出し元であるオブジェクトを指します。 たとえば:

$o:=New object("prop";42;"f";Formula(This.prop))
$val:=$o.f() //42

クラスコンストラクター メソッドが new() キーワードで使用された場合、その内部の This はインスタンス化される新規オブジェクトを指します。

  // クラス: ob

Class Constructor  
    // This のプロパティを
    // 代入によって作成します
    This.a:=42 

    // 4D メソッド
$o:=cs.ob.new()
$val:=$o.a //42

コンストラクター内で Super キーワードを使ってスーパークラスのコンストラクターを呼び出す場合、必ず This よりも先にスーパークラスのコンストラクターを呼ぶ必要があることに留意してください。順番を違えるとエラーが生成されます。 こちらの例題 を参照ください。

基本的に、This はメソッドの呼び出し元のオブジェクトを指します。

 // クラス: ob

 Function f
    $0:=This.a+This.b

この場合、プロジェクトメソッドには次のように書けます:

$o:=cs.ob.new()
$o.a:=5
$o.b:=3
$val:=$o.f() //8

この例では、変数 $o に代入されたオブジェクトは f プロパティを持たないため、これをクラスより継承します。 f は $o のメソッドとして呼び出されるため、メソッド内の This は $o を指します。

クラスコマンド

4D ランゲージには、クラス機能を扱う複数のコマンドがあります。

OB Class

OB Class ( object ) -> Object | Null

OB Class は引数として渡したオブジェクトのクラスを返します。

OB Instance of

OB Instance of ( object ; class ) -> Boolean

object が class、またはその子クラスに属していれば、OB Instance of は true を返します。それ以外の場合は false を返します。