Classes · 4D Documentation

概要

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

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

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

たとえば、次のように Person クラスを定義した場合:

// クラス: Person.4dm
Class constructor($firstname : Text; $lastname : Text)
    This.firstName:=$firstname
    This.lastName:=$lastname

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

var $o : cs.Person // Person クラスのオブジェクト
$o:=cs.Person.new("John";"Doe")
// $o:{firstName: "John"; lastName: "Doe" }

クラスの管理

クラス定義

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

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

クラス名はプロパティ名の命名規則に準拠している必要があります。
大文字と小文字が区別されること
競合防止のため、データベースのテーブルと同じ名前のクラスを作成するのは推奨されないこと

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

Project フォルダー
- Project
  - Sources
    - Classes
      - Polygon.4dm

クラスの削除

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

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

4D インターフェースの使用

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

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

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

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

エクスプローラー

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

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

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

クラスのコードサポート

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

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

クラスストア

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

cs - ユーザークラスストア
4D - ビルトインクラスストア

cs

cs -> classStore

引数	タイプ		説明
classStore	オブジェクト	<-	プロジェクトまたはコンポーネントのユーザークラスストア

cs コマンドは、カレントプロジェクトまたはコンポーネントのユーザークラスストアを返します。これには、プロジェクトまたはコンポーネントにて定義されている、すべてのユーザークラスが含まれます。デフォルトでは、 ORDAクラスのみ利用可能です。

例題

myClass オブジェクトの新規インスタンスを作成するには、次のように書きます:

$instance:=cs.myClass.new()

4D

4D -> classStore

引数	タイプ		説明
classStore	オブジェクト	<-	4Dクラスストア

4D コマンドは、ビルトイン 4Dクラスのクラスストアを返します。 CryptoKey などの専用 API へのアクセスを提供します。

例題

CryptoKey クラスに新規キーを作成するには、次のように書きます:

$key:=4D.CryptoKey.new(New object("type";"ECDSA";"curve";"prime256v1"))

コード内のクラスの使用

Class オブジェクト

プロジェクトにおいてクラスが定義されていれば、それは 4Dランゲージ環境に読み込まれます。クラスとは、それ自身が "Class" クラスのオブジェクトです。 Class オブジェクトは次のプロパティやメソッドを持ちます:

name 文字列
superclass オブジェクト (任意。無ければ null)
new() メソッド: Class オブジェクトをインスタンス化します

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

constructor オブジェクト (任意),
prototype オブジェクト: 名前付きの関数オブジェクトを格納します (任意)

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

new() メソッド

cs.<ClassName>.new() -> classObject

引数	タイプ		説明
classObject	オブジェクト	<-	New object of the <ClassName> class

new() メソッドは、呼び出し対象である <ClassName> クラスの新規インスタンスであるオブジェクトを作成して返します。このメソッドは、cs クラスストアの全クラスで自動的に利用可能です。

存在しないクラスを対象に呼び出された場合、エラーが返されます。

例題

Person クラスの新規インスタンスを作成するには、次のように書きます:

var $person : cs.Person // 正確な自動補完のため  
$person:=cs.Person.new() // 新規インスタンスの作成  
//$Person はクラス関数を格納しています

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

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

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

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

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

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

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

// クラス: Polygon
Class constructor($width : Integer; $height : Integer)
    This.area:=$width*$height

    //var $poly : Object
    var $instance : Boolean
    $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 コマンドは、クラスプロトタイプオブジェクトのプロパティを返しません。クラスのプロトタイプオブジェクトプロパティは、内部的な隠れプロパティです。

クラスキーワード

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

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

Function

シンタックス

Function <name>({$parameterName : type; ...}){->$parameterName : type}
// コード

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

クラス定義ファイルでは、Function キーワードと関数名を使用して宣言をおこないます。関数名はプロパティ名の命名規則に準拠している必要があります。

Tip: アンダースコア ("_") 文字で関数名を開始すると、その関数は 4Dコードエディターの自動補完機能から除外されます。たとえば、MyClass に Function _myPrivateFunction を宣言した場合、コードエディターにおいて "cs.MyClass " とタイプしても、この関数は候補として提示されません。

関数名のすぐ後に、名前とデータ型を指定して引数を宣言します (戻り値の宣言も可)。たとえば:

Function computeArea($width : Integer; $height : Integer)->$area : Integer

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

Function setFullname($firstname : Text; $lastname : Text)
    This.firstName:=$firstname
    This.lastName:=$lastname

Function getFullname()->$fullname : Text
    $fullname:=This.firstName+" "+Uppercase(This.lastName)

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

アプリケーションのコード内では、クラス関数はオブジェクトインスタンスのメンバーメソッドとして呼び出され、<a href="#クラス関数の引数>引数を受け取ることができます。次のシンタックスがサポートされています:

() 演算子の使用例: myObject.methodName("hello")
"Function" クラスメンバーメソッドの使用:
- apply()
- call()

スレッドセーフに関する警告: クラス関数がスレッドセーフではないのに、"プリエンプティブプロセスで実行可能" なメソッドから呼び出された場合: - 普通のメソッドの場合とは異なり、コンパイラーはエラーを生成しません。 - ランタイムにおいてのみ、4D はエラーを生成します。

引数

関数の引数は、引数の名称とデータ型をコロンで区切って宣言します。引数名はプロパティ名の命名規則に準拠している必要があります。複数のパラメーター (およびその型) を宣言する場合は、それらをセミコロン (;) で区切ります。

Function add($x; $y : Variant; $z : Integer; $xy : Object)

パラメーターの型が宣言されていない場合には、バリアント型 として定義されます。

関数の戻り値を宣言するには (任意)、入力パラメーターリストに矢印 (->) と戻り値の定義を追加します。 XPath: /ul[5]/li[2]/ClassName/ClassName/FunctionName/p[22] たとえば:

Function add($x : Variant; $y : Integer)->$result : Integer

戻り値は、コロン (:) 記号の後に戻り値のデータ型だけを指定して宣言することもできます。その場合は、自動的に $0 が使用されます。たとえば:

Function add($x : Variant; $y : Integer): Integer
    $0:=$x+$y

メソッド内の引数宣言に使用される従来の 4D シンタックスを、クラス関数の引数宣言に使うこともできます。両方のシンタックスは併用することができます。たとえば:

Function add($x : Integer) var $2; $value : Integer var $0 : Text $value:=$x+$2 $0:=String($value)




#### 例題

```4d
// クラス: Rectangle
Class Constructor($width : Integer; $height : Integer)
    This.name:="Rectangle"
    This.height:=$height
    This.width:=$width

// 関数定義
Function getArea()->$result : Integer
    $result:=(This.height)*(This.width)

// プロジェクトメソッドにて
var $rect : cs.Rectangle
var $area : Real

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

Class Constructor

シンタックス

// クラス: MyClass
Class Constructor({$parameterName : type; ...})
// コード

クラスコンストラクター関数を使って、ユーザークラスを定義することができます。このコンストラクターは引数を受け取ることができます。

クラスコンストラクターが定義されていると、new() クラスメンバーメソッドを呼び出したときに、当該コンストラクターが呼び出されます (引数を指定している場合は new() 関数に渡します)。

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

例題:

// クラス: MyClass
// MyClass のクラスコンストラクター
Class Constructor ($name : Text)
    This.name:=$name

// プロジェクトメソッドにて
// オブジェクトをインスタンス化します
var $o : cs.MyClass
$o:=cs.MyClass.new("HelloWorld")  
// $o = {"name":"HelloWorld"}

Class extends <ClassName>

シンタックス

// クラス: ChildClass
Class extends <ParentClass>

クラス宣言において Class extends キーワードを使うと、別のユーザークラスの子ユーザークラスを作成することができます。この子クラスは、親クラスのすべての機能を継承します。

クラス継承は次のルールに沿っている必要があります:

ユーザークラスはビルトインクラスを継承できません (例外は 4D.Object で、すべてのユーザークラスにデフォルトで継承されます)
ユーザークラスは、別のプロジェクトやコンポーネントのユーザークラスを継承できません。
ユーザークラスは、自身を継承することはできません。
間接的にも、自身を継承することはできません (例: "a" extends "b" かつ "b" extends "a")。

コードエディターやインタープリターは、これらのルールが破られていても検知することはできません。コンパイラーおよび "シンタックスチェック" のみがエラーを生成します。

派生クラスは、Super コマンドを使って親クラスのコンストラクターを呼び出すことができます。.

例題

Polygon クラスを継承した Square クラスを作成します。

// クラス: Square
// パス: Classes/Square.4dm 

Class extends Polygon

Class constructor ($side : Integer)

    // 親クラスのコンストラクターを呼び出します
    // 長方形の高さ・幅パラメーターに正方形の一辺の長さを引数として渡します
    Super($side;$side)
    // 派生クラスにおいては、'This' を使用するより先に
    // Super を呼び出しておく必要があります
    This.name:="Square"

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

Super

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

引数	型		説明
param	mixed	->	親コンストラクターに受け渡す引数
戻り値	object	<-	親オブジェクト

Super キーワードによってスーパークラス (親クラス) を呼び出すことができます。

Super は次の2つの目的のために使います:

コンストラクターコード内において、 Super はスーパークラスのコンストラクターを呼び出すコマンドです。コンストラクター内で使用する際には、Super コマンドは単独で使用され、また This キーワードよりも先に使用される必要があります。
- 継承ツリーにおいて、すべてのクラスコンストラクターが正しく呼び出されていない場合には、エラー -10748 が生成されます。呼び出しが有効であることを確認するのは、開発者の役目となります。
- スーパークラスがコンストラクトされるより先に、This コマンドを使った場合には、エラー -10743 が生成されます。
- Super を、オブジェクトのスコープ外で呼び出した場合、または、スーパークラスコンストラクターがすでに呼び出されたオブジェクトを対象に呼び出した場合には、エラー -10746 が生成されます。

// myClass コンストラクター
var $text1; $text2 : Text
Super($text1) // テキスト型引数をスーパークラスコンストラクターに渡します
This.param:=$text2 // 2番目の引数を使用します

クラスメンバー関数内において、Super はスーパークラスのプロトタイプを指し、スーパークラス階層のメンバーメソッドの呼び出しを可能にします。

Super.doSomething(42) // スーパークラスにて宣言されている
// "doSomething" メンバーメソッドを呼び出します

例題 1

クラスコンストレクター内で Super を使う例です。 Rectangle と Square クラスの共通要素がコンストラクター内で重複しないよう、このコマンドを呼び出します。

// クラス: Rectangle
Class constructor($width : Integer; $height : Integer)
    This.name:="Rectangle"
    This.height:=$height
    This.width:=$width


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

// 関数定義
Function getArea()
    var $0 : Integer
    $0:=(This.height)*(This.width)

// クラス: Square

Class extends Rectangle

Class constructor ($side : Integer)

    // 親クラスのコンストラクターを呼び出します
    // 長方形の高さ・幅パラメーターに正方形の一辺の長さを引数として渡します
    Super($side;$side)
    // 派生クラスにおいては、'This' を使用するより先に
    // Super を呼び出しておく必要があります
    This.name:="Square"

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

例題 2

クラスメンバーメソッド内で Super を使う例です。メンバーメソッドを持つ Rectangle クラスを作成します:

// クラス: Rectangle

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

Square クラスには、スーパークラスメソッドを呼び出すメンバーメソッドを定義します:

// クラス: Square

Class extends Rectangle

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

すると、プロジェクトメソッド内には次のように書けます:

var $square : Object
var $message : Text
$square:=cs.Square.new()
$message:=$square.description() // "I have 4 sides which are all equal"

This

This -> Object

引数	型		説明
戻り値	object	<-	カレントオブジェクト

This キーワードは、現在処理中のオブジェクトへの参照を返します。 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 を返します。