• « 前の投稿
• 次の投稿 »

February 21, 2017

NSTreeControllerで使用するObjectの変換についてのメモ

NSTreeControllerでnodeを示すのに使用されるObject

NSTreeNode

NSTreeControllerで木構造のノードを管理しやすくするためのクラス。このクラスのインスタンスから、自分自身のNSIndexPathや、NSManagedObjectへの参照を得ることができる。 親ノード、小ノードを手繰ることが出来る。

NSIndexPath

ノードの位置を数字の列で指定するクラス。各ノードは、親のオブジェクトのNSArrayに入っている。 この、NSArrayのindexの値を複数持つことで、fileSystemのパスのように目的のノードの位置を指定することができる。 2/22追記:選択範囲を”状態の保存”で保存する場合は、このindexPathを使用するのが望ましい。NSTreeNodeやNSManagedObjectは保存ファイルやポインターに依存しているので、識別子の変換作業が追加で必要になる。

NSManagedObject

NSTreeControllerが参照するモデルとしてCoraDateを使用する場合に、ノードのデータ本体としてこのクラスのサブクラスが使用される。NSTreeNodeのrepresentedObjectに設定される。

row

NSTreeControllerがNSTableViewやNSOutlineViewに結び付けられている時に、表示中の0から始まる行番号を示す。表示上の値であるため、兄弟ノードの子ノードが表示の為に開閉されると、子ノード分増減する。

上記のObjectの相互変換

NSTreeNodeから各種Objectへの変換

もっとも簡単に変換できる。気をつけることは、rowはviewにしか存在しない概念なので、NSOutlineViewで変換するしかないことぐらい。

型	方法
NSIndexPath	NSTreeNode.indexPath
NSManagedObject	NSTreeNode.representedObject
row	[NSOutlineView rowForItem:NSTreeNode]

NSIndexPathから各種Objectへの変換

一度NSTreeNodeに変換してからそれぞれの型に変換する。

型	方法
NSTreeNode	[NSTreeController.arrangedObjects descendantNodeAtIndexPath:NSIndexPath]
NSManagedObject	[NSTreeController.arrangedObjects descendantNodeAtIndexPath:NSIndexPath].representedObject
row	[NSOutlineView rowForItem:[NSTreeController.arrangedObjects descendantNodeAtIndexPath:NSIndexPath]]

NSManagedObjectから各種Objectへの変換

NSTreeController.arrangedObjectsを使って、総なめする以外には方法はない。

コーディングするときは、NSManagedObjectは中間表現としては使ってはならない。NSIndexPathかNSTreeNodeを使用すること。

rowから各種Objectへの変換

rowはviewにしか存在しない概念なので、NSOutlineViewでNSTreeNodeへ変換する。 その後、それぞれの型に変換する。

型	方法
NSIndexPath	[NSOutlineView itemAtRow:row].indexPath
NSTreeNode	[NSOutlineView itemAtRow:row]
NSManagedObject	[NSOutlineView itemAtRow:row].representedObject

なお、キャストなどは省略した。上記のコードはコピペでは動かない。

投稿者 MindTo01s

カテゴリー: note

タグ: cocoa, NSTreeController, NSTreeNode, CoreData

Leave a comment

February 06, 2017

sphinxのadmonition用にcssを書いたの続き

前回のアイコンはサイズも適当に作成していた。画像の余白を削り、サイズも統一した。 さらに、CSSを変更して、タイトル部分をboldにして、それぞれの要素のマージンを合わせた。

Caution

caution用のディレクティブはこう。old mac風のアイコンで区別できるようにしてみてます。なかなかにそれっぽくできた。

Danger

危険(?)のディレクティブをかくとこんな感じ。前回は爆弾マークだったのだが、テロ推奨マークのようであまりいい感じがしなかったので、ドクロマークに変更した。

Note

ノート用のディレクティブはこう。この”Note”や”Danger”の文字を消すには、コラムディレクティブ(http://sphinx-users.jp/cookbook/columndirective/index.html)を使う必要があるみたい。CSSのfloat属性とPaddingをうまく使って、”Note”や”Danger”の文字をアイコンの下へつけるようにした。

Tip

tipのディレクティブをかくとこんな感じ。本文の上辺のpaddingもアイコンの上辺と合わせたつもり。

Warning

警告用のディレクティブをかくとこんな感じ。種類によって背景色も変えた方が良いかもと思って色々と試した。が、色をつけると以外に下品になる。色についてはAppleHelpFileを作るときにもう少し考えてから行うことにする。

cssの実装方法は、htmlのソースとcssのソースを見ればすぐにわかると思うので特に記述しない。

投稿者 MindTo01s

カテゴリー: note

タグ: sphinx, tinker

Leave a comment

January 31, 2017

sphinxのadmonition用にcssを書いた

適当にアイコンを作り、コラム風に囲ってみた。

cssの実装方法は、htmlのソースとcssのソースを見ればすぐにわかると思うので特に記述しない。

(注意) CSSを変更して、再ビルドしたため上記は、画像ファイルに差し替えた。

投稿者 MindTo01s

カテゴリー: note

タグ: sphinx, tinker

Leave a comment

January 25, 2017

NSAtomicStoreサブクラスの作成のメモ

CoreDataがサポートしてい保存形式

CoreDataはデータ保存形式として予め以下の4つの形式をサポートしている。

	指定文字列	description
SQLite	NSSQLiteStoreType	SQLiteに保存する
バイナリ	NSBinaryStoreType	バイナリ形式でfileに保存する
XML	NSXMLStoreType	XML形式でfileに保存する。iOSにはない。
in Mmemory	NSInMemoryStoreType	メモリだけ使用し保存しない。

これらのStoreTypeを目的に応じて使い分けることができる。そして目的に合わない場合に、自作することも可能である。

クラス階層

ここでは、NSBinaryStoreTypeやNSXMLStoreTypeと同じatomicな読み書きを行い、独自のファイ形式をサポートするStoreタイプの作成方法を説明する。

まずは、既存のStoreTypeがどのクラス階層に属しているかを示す。 残念ながら、既存のStoreTypeのクラスはドキュメント化されていないので指定用文字列をクラス名の代わりに使用している。

クラスNSPersistentStoreは、CoreDataで使用する永続化方式の抽象クラスです。このクラスのサブクラスを書くことで、CoreDataのデータを任意の媒体に保存できるようになる。 デザインパターンで言うところの、テンプレートパタンやストラテジーパタンで設計されている。

NSIncrementalStoreは、部分的に保存することができるStoreの抽象クラスです。既存のクラスではNSSQLiteStoreTypeがこのクラスを継承している。他のデータベースやNoSQL的なものをサポートしたい場合は、このクラスを継承して作ることになる。

NSAtomicStoreは、データを保存するときに一括で保存する必要があるStoreの抽象クラスです。既存のクラスではNSBinaryStoreTypeとNSXMLStoreTypeがこのクラスを継承している。

このNSAtomicStoreのサブクラスを作成することで、CoreDataの保存形式に独自のファイルフォーマットを導入する。

実行時のオブジェクトグラフとNSAtomicStoreCacheNode

NSAtomicStoreのサブクラスの内部では、NSManagedObjectのデータをNSAtomicStoreCacheNodeに対1で転写して使用する。 NSAtomicStoreCacheNodeはサブクラス化しなくとも問題なく使える。

NSAtomicStoreCacheNodeとNSManagedObjectとNSAtomicStoreの関係は、以下の3点だけ覚えておけば問題ないはず。

1. NSAtomicStoreCacheNodeはNSAtomicStoreに所有される。
2. NSAtomicStoreCacheNodeはNSManagedObjectと1:1で関係する。
3. NSAtomicStoreCacheNodeを区別する識別子を割り当てる。

図で示すと、以下のようになる。

NSAtomicStoreをサブクラス化するには

NSAtomicStoreをサブクラス化するにあたっての、上書きすべきメソッドは大別して2つのグループに分かれる。

メタデータの管理系のメソッド

- (id)initWithPersistentStoreCoordinator:(NSPersistentStoreCoordinator*)coordinator
                       configurationName:(NSString*)configurationName
                                     URL:(NSURL*)anUrl
                                 options:(NSDictionary *)options

+ (NSDictionary *)metadataForPersistentStoreWithURL:(NSURL*) url
                                              error:(NSError*__autoreleasing*) error

+ (BOOL)        setMetadata:(NSDictionary*) metadata
  forPersistentStoreWithURL:(NSURL*) url
                      error:(NSError*__autoreleasing*) error

- (NSString*)type
- (NSString*)identifier

• initWithPersistentStoreCoordinator…は、初期化メソッド。ここで、メタデータを読み込むか初期化する必要がある。
• metadataForPersistentStoreWithURL…は、メタデータの読み込みメソッド。指定されたURLからメタデータを読み込む。
• setMetadata…は、メタデータの書き込みメソッド。指定されたURLからメタデータを書き込む。
• typeは、クラスの識別子を返します。この識別子によって、CoreDataは新たに作成したNSAtomicStoreのサブクラスを認識できます。[NSPersistentStoreCoordinator registerStoreClass:forStoreType:]に渡す文字列。NSSQLiteStoreTypeやNSXMLStoreTypeと同じ目的の文字列。
• identifierはインスタンスの識別子です。保存して再生した場合は、また同じ値を返す必要があります。そーでないと識別子として動作しない。

NSAtomicStoreCacheNodeの管理系のメソッド

- (BOOL)load:(NSError*__autoreleasing*) error
- (BOOL)save:(NSError*__autoreleasing*) error

- (NSAtomicStoreCacheNode*)newCacheNodeForManagedObject:(NSManagedObject*) inManagedObject
- (void)updateCacheNode:(NSAtomicStoreCacheNode*)node fromManagedObject:(NSManagedObject*)managedObject
- (id)newReferenceObjectForManagedObject:(NSManagedObject*) managedObject

• load…はファイルからデータを読み込ませる。
• save…はファイルへ保存させる。
• newCacheNodeForManagedObject..は与えられたNSManagedObjectに対応するNSAtomicStoreCacheNodeを作成する
• updateCacheNode…はnodeへmanagedObjectの内容を反映させる。
• newReferenceObjectForManagedObjectはNSManagedObjectの識別子を生成する。保存して再生した場合は、また同じ値を返す必要があります。そーでないと識別子として動作しない。

ファイルフォーマットの設計

NSAtomicStoreのサブクラスを作成して、CoreDataを任意のファイルフォーマットに対応させるにはいくつかの条件がある。

1. ファイルを区別するためのNSStoreUUIDKeyの値の保存が必要。メソッドidentifierがその値を返す必要がある。
2. レコードに相当するNSManagedObjectを区別するための、リファレンスの保存が必要。
3. テーブルに相当する値を何らかの方法で識別する必要がある。

ここで、plist形式やxml形式などの汎用ファイルフォーマット形式であれば対応可能。既存のファイルフォーマットに上記の条件を合わせるには何らかの工夫が必要になる。

全てのCoreDateのファイルを保存するのでなければ、それなりに簡単にできる。

ここでは、以前作成したToDoアプリ元にcsv形式での読み書きをサポートさせてみる。

以下のようにした。

1. 1行目はメタファイル行。metaDataのUUIDの値
2. 2行目以降は通常のcsvファイル
3. ToDoアプリのみサポート。テーブル名は保存しない。
4. 項目は、done, memo, sortOrder, 作成日, uuid(レコードのuuid値)

具体的にはこんな感じ。

#D35CF030-1EC1-4667-9666-70C8247A1010
1, insertCurrent, 2, 2016-09-17 18:15:00 +0000, E899556C-BE1A-42A3-A634-F8411915C05F
0, insertCurrent, 5, 2016-09-17 18:15:00 +0000, 803054FC-C497-4DD7-A078-CF592B994EB4
1, insertCurrent, 3, 2016-09-17 18:15:00 +0000, 569485BA-A1E2-4E5B-88B5-6D5DB2C8AB8F
0, insertCurrent, 1, 2016-09-17 18:15:00 +0000, 65A95220-A09F-4000-9F3C-EC8448D5DCB7
0, addLast, 0, 2016-09-17 18:15:00 +0000, F7C54A12-8CA6-4A4A-9D45-1A92E23922F9
1, insertCurrent, 4, 2016-09-17 18:15:00 +0000, 5CE1C138-32A3-4CE8-9917-84C941011C09

CoreDataへの登録とinfo.plistへの追加

NSAtomicStoreのサブクラスを使用するには、NSPersistentStoreCoordinatorに登録する必要がある。 適当な場所に以下のコードを書いて、登録する。applicationDidFinishLaunchingが良いと思う。

[NSPersistentStoreCoordinator registerStoreClass:[TDLAtomicStore class]
                                    forStoreType:TDLAtomicStoreType];

同じく、NSPersistentDocumentと一緒に使う場合は、info.plsitにDocument typeを追加する。

<key>CFBundleDocumentTypes</key>
               <dict>
                       <key>CFBundleTypeExtensions</key>
                       <array>
                               <string>csv</string>
                       </array>
                       <key>CFBundleTypeMIMETypes</key>
                       <array>
                               <string>text/csv</string>
                       </array>
                       <key>CFBundleTypeName</key>
                       <string>CSV</string>
                       <key>CFBundleTypeRole</key>
                       <string>Editor</string>
                       <key>LSTypeIsPackage</key>
                       <integer>0</integer>
                       <key>NSDocumentClass</key>
                       <string>TDLDocument</string>
                       <key>NSPersistentStoreTypeKey</key>
                       <string>TDLAtomicStoreType</string>
               </dict>

と登録しておけばOK。これで、.csvの拡張子のファイルを開けるようになるし、”save as..”でTDLAtomicStoreTypeの保存方式が使えるようになる。

ソースコードの解説

めんどくさくなってきたので、Cocoa勉強会Matudoで説明します。https://connpass.com/event/46754/

ファイルTDLCSVAtomicStore.h.mにまとまってます。

ソースコードはここ。( ModernToDoList_atomicStore.zip )

投稿者 MindTo01s

カテゴリー: note

タグ: cocoa, NSAtomicStore, CoreData, NSPersistentStore

Leave a comment

— ブログアーカイブ —

• « 前の投稿
• 次の投稿 »

最近の投稿

• キーボードショートカットのデバッグ用コード
• 非公開APIを使わない、Migemoみたいな逐次検索
• TSMが変換候補を表示しているか否かの判定
• ローマ字かな変換表
• NSTextViewにCommand Paletteをつける
• 午前1時、室温は29度。エアコンの調子がおかしい。
• NSUserDefaultsControllerでbinding出来るデータ構造についてのメモ
• 室温が30度を超える。
• Symbol font を使う
• NSUserDefaultsControllerでUndo/Redo

カテゴリー

• article (23)
• discovery (11)
• note (160)
• reference (33)
• study (1)

タグ

ActionPopupButton (1), addLocalMonitorForEvents(matching:handler:) (1), applicationDidBecomeActive (1), ARC (1), arduino (1), bash (4), binding (1), business (1), CALayer (1), CATransaction (1), CFBundleDocumentTypes (1), CFStringTransform (1), CGRect (1), cocoa (125), Cocoa (3), Cocoa binding (1), cocoa-study (1), cocoaBinding (3), CocoaBinding (1), CodeSign (1), codeSign (1), CommandPallete (1), Container View (2), Copy&Paste (2), CoreData (6), css (1), custumFieldEditor (1), ditz (9), DocumentDefaults (1), doxygen (3), Drag & Drop (1), Drag&Drop (3), etc (13), expect (1), FontWell (1), FSEvent (1), git (2), graphics (4), IB_DESIGNABLE (1), IBInspectable (1), iCloud (1), infoPlist (1), initialFirstResponder (2), JIMPrefLiveConversionKey (1), kCFStringTransformLatinHiragana (1), kext (2), key event (1), KeyValueCoding (1), latex (8), lifeGame (5), LiveConversion (2), lldb (1), macPort (3), macPorts (2), Migemo (1), mutableArrayValue (2), nib (2), noteApp (2), NSArchiver (1), NSArrayController (3), NSAtomicStore (1), NSBezierPath (2), NSBox (1), NSBrowser (5), NSBundle (1), NSCell (2), NSColorWell (1), NSControl (1), NSDistributedNotification (1), NSDocument (4), NSError (1), NSEvent (2), NSFileWrapper (2), NSFont (1), NSFontManager (2), NSInvocation (3), NSKeyedArchiver (2), NSMenu (2), NSMenuItem (3), NSMuenu (1), NSNib (1), NSOpenPanel (1), NSOrderdSet (1), NSOutlineView (1), NSPanel (2), NSPasteboard (5), NSPasteboardItem (5), NSPersistentStore (1), NSPopuoButton (1), NSRect (1), NSResponder (3), NSRestorableState (1), NSScroller (1), NSScrollView (2), NSSegmentedControl (1), NSServices (1), NSServicesMenuRequestor (1), NSShadow (1), NSSplitView (3), NSSplitViewController (1), NSStoryboard (2), NSStoryboardSegue (2), NSTableView (5), NSTabPickerViewController (1), NSTask (1), NSTextField (2), NSTextFinder (2), NSTextInputClient_IncrementalSearch (1), NSTextView (3), NSTreeController (2), NSTreeNode (1), NSUndoManager (2), NSUserDefaults (5), NSUserDefaultsController (2), NSViewController (2), NSVisualTabPickerRootViewController (1), NSWindow (6), NSWindowController (4), NSWindowStackController (1), objectAtIndexedSubscript: (1), objectAtKeyedSubscript: (1), Objective-C (4), PAC (1), plantUML (1), png (1), podcast (1), pragmaMark (1), prepareForSegue:sender: (2), preprocesser (1), presentAsModalWindow (2), presentAsSheet (2), proxyResponder (1), queue (1), quickLook (1), registerServicesMenuSendTypes (1), removeMonitor(_:) (1), restoreState (3), RuleEngine (1), SCEvents (1), ServicesMenu.strings (1), SF Font (1), SF Symbols (1), singleton (1), sphinx (19), spotlight (1), storyboard (1), swift (16), Swyft (3), SymbolFontApp (1), TabUI (1), Text Service Manager (1), TikZ (1), tinker (13), toggleTabOverview (1), TSM (1), UI (4), uncrustify (3), unix (10), update (1), validateUserInterfaceItem (10), validRequestor (1), versionNumber (1), VirtualBox (7), xcode (11), xib (3), xml (1), yaml (1), インスペクタパネル (2), ドットファイル (1), ヒレガス本 (21), メソッド名合成プログラミング (2), ローカライズ (2), ローマ字かな変換 (1), 文字列定数 (1), 添字演算子オーバーロド (1), 状態の保存 (1), 落穂拾い (22), 表 (1), 長押し (1), 開発環境 (7)

Search