svnno****@sourc*****
svnno****@sourc*****
2009年 4月 3日 (金) 20:22:20 JST
Revision: 3086
http://svn.sourceforge.jp/view?root=jiemamy&view=rev&rev=3086
Author: daisuke_m
Date: 2009-04-03 20:22:20 +0900 (Fri, 03 Apr 2009)
Log Message:
-----------
javadoc
Modified Paths:
--------------
artemis/trunk/jiemamy-artemis-test/src/test/java/org/jiemamy/sandbox/daisuke/Daisuke.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/AbstractDialect.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/DialectInitializer.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/EntityImportVisitor.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/ForeignKeyImportVisitor.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/SqlEmitter.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/EventBrokerImpl.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AbstractAddToCollectionCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AbstractCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddAttributeCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddColumnToColumnRefListCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddDataSetToRootCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddDomainToRootCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddIndexColumnCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddIndexCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveColumnFromColumnRefListCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveDataSetFromRootCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveDomainFromRootCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveEntityFromRootCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveIndexColumnCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveIndexCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/SwapListElementCommand.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/enhance/FactoryExtension.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/serializer/JiemamyDomBuilder.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/serializer/JiemamyDomParser.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/serializer/JiemamyDomSerializer.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/DateUtil.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/DriverUtil.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/EssentialQueue.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/ForEachUtil.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/JmIOUtil.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/UUIDUtil.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/model/TableUtil.java
artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/swap/Swapper.java
artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/composer/importer/DatabaseImporterTest.java
artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/internal/test/TestModelBuilder2Test.java
artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/utils/ArrayEssentialStackTest.java
artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/utils/builder/TableBuilderTest.java
artemis/trunk/jiemamy-dialect-postgresql/src/main/java/org/jiemamy/dialect/postgresql/adapter/PostgresObjectOption.java
artemis/trunk/jiemamy-dialect-postgresql/src/main/java/org/jiemamy/dialect/postgresql/adapter/TableOption.java
artemis/trunk/jiemamy-view/src/main/java/org/jiemamy/internal/enhance/ViewFactoryExtensionEnhancer.java
artemis/trunk/jiemamy-view/src/main/java/org/jiemamy/internal/enhance/ViewFactoryExtensionEnhancer2.java
-------------- next part --------------
Modified: artemis/trunk/jiemamy-artemis-test/src/test/java/org/jiemamy/sandbox/daisuke/Daisuke.java
===================================================================
--- artemis/trunk/jiemamy-artemis-test/src/test/java/org/jiemamy/sandbox/daisuke/Daisuke.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-artemis-test/src/test/java/org/jiemamy/sandbox/daisuke/Daisuke.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -40,7 +40,8 @@
/**
* 実験。
- * @throws Exception
+ *
+ * @throws Exception 例外が発生した場合
*/
@Test
public void testname() throws Exception {
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/AbstractDialect.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/AbstractDialect.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/AbstractDialect.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -35,6 +35,7 @@
import org.jiemamy.dialect.MoldManager;
import org.jiemamy.model.RootModel;
import org.jiemamy.model.attribute.constraint.ForeignKey;
+import org.jiemamy.model.datatype.DataType;
import org.jiemamy.model.datatype.DataTypeCategory;
import org.jiemamy.model.entity.EntityModel;
import org.jiemamy.model.sql.SqlStatement;
@@ -49,26 +50,29 @@
*/
public abstract class AbstractDialect implements Dialect {
- /** {@link DataTypeResolver} */
+ /** データ型（{@link DataType}）を中心とした各種解決を行うロジック */
private final DataTypeResolver dataTypeResolver;
- /** {@link ConnectionAdvisor} */
+ /** DBメタデータの読み出し前後に実行するロジック */
private final ConnectionAdvisor advisor;
/** SQLエミッタ */
private final SqlEmitter emitter;
+ /** データ型鋳型マネージャ */
private final MoldManager moldManager;
+ /** DBからエンティティ情報をインポートするビジター */
private final EntityImportVisitor entityImportVisitor;
+ /** DBから外部キー情報をインポートするビジター */
private final ForeignKeyImportVisitor foreignKeyImportVisitor;
/**
* インスタンスを生成する。
*
- * @param initializer
+ * @param initializer SQL方言の各ストラテジを提供するイニシャライザ
* @throws IllegalArgumentException 引数に{@code null}または空のコレクションを与えた場合
*/
public AbstractDialect(DialectInitializer initializer) {
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/DialectInitializer.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/DialectInitializer.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/DialectInitializer.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -21,54 +21,57 @@
import org.jiemamy.dialect.ConnectionAdvisor;
import org.jiemamy.dialect.DataTypeResolver;
import org.jiemamy.dialect.MoldManager;
+import org.jiemamy.model.RootModel;
+import org.jiemamy.model.datatype.DataType;
-
/**
- * TODO for daisuke
+ * SQL方言の各ストラテジを提供するイニシャライザインターフェイス。
*
+ * <p>{@link AbstractDialect}を初期化するための情報を取得することができる。</p>
+ *
* @author daisuke
*/
public interface DialectInitializer {
/**
- * TODO for daisuke
+ * DBメタデータの読み出し前後に実行するロジッククラスを取得する。
*
- * @return
+ * @return DBメタデータの読み出し前後に実行するロジッククラス
*/
ConnectionAdvisor getConnectionAdvisor();
/**
- * TODO for daisuke
+ * データ型（{@link DataType}）を中心とした各種解決を行うロジッククラスを取得する。
*
- * @return
+ * @return データ型（{@link DataType}）を中心とした各種解決を行うロジッククラス
*/
DataTypeResolver getDataTypeResolver();
/**
- * TODO for daisuke
+ * エンティティメタ情報から{@link RootModel}にインポートを行うビジターを取得する。
*
- * @return
+ * @return エンティティメタ情報から{@link RootModel}にインポートを行うビジター
*/
EntityImportVisitor getEntityImportVisitor();
/**
- * TODO for daisuke
+ * 外部キーメタ情報から{@link RootModel}にインポートを行うビジターを取得する。
*
- * @return
+ * @return 外部キーメタ情報から{@link RootModel}にインポートを行うビジター
*/
ForeignKeyImportVisitor getForeignKeyImportVisitor();
/**
- * TODO for daisuke
+ * データ型鋳型の管理クラスを取得する。
*
- * @return
+ * @return データ型鋳型の管理クラス
*/
MoldManager getMoldManager();
/**
- * TODO for daisuke
+ * {@link RootModel}からSQLのリストを生成するエミッタを取得する。
*
- * @return
+ * @return {@link RootModel}からSQLのリストを生成するエミッタ
*/
SqlEmitter getSqlEmitter();
}
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/EntityImportVisitor.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/EntityImportVisitor.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/EntityImportVisitor.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -30,20 +30,20 @@
import org.jiemamy.utils.metadata.TypeSafeDatabaseMetaData;
/**
- * TODO for daisuke
+ * エンティティメタ情報から{@link RootModel}にインポートを行うビジターインターフェイス。
*
* @author daisuke
*/
public interface EntityImportVisitor extends CollectionVisitor<TableMeta, Void, SQLException> {
/**
- * TODO for daisuke
+ * ビジターを初期化する。
*
* @param meta DBメタデータ
- * @param rootModel 書き込み先モデル
+ * @param rootModel インポート先の{@link RootModel}
* @param config インポートに関するコンテキスト情報
- * @param importedEntities
- * @param dataTypeResolver
+ * @param importedEntities インポートされたエンティティを格納する{@link Map}
+ * @param dataTypeResolver データ型リゾルバ
*/
void intialize(TypeSafeDatabaseMetaData meta, RootModel rootModel, ImportMetadataConfig config,
Map<String, EntityModel> importedEntities, DataTypeResolver dataTypeResolver);
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/ForeignKeyImportVisitor.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/ForeignKeyImportVisitor.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/ForeignKeyImportVisitor.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -26,17 +26,17 @@
import org.jiemamy.utils.metadata.KeyMeta;
/**
- * TODO for daisuke
+ * 外部キーメタ情報から{@link RootModel}にインポートを行うビジターインターフェイス。
*
* @author daisuke
*/
public interface ForeignKeyImportVisitor extends CollectionVisitor<KeyMeta, Void, RuntimeException> {
/**
- * TODO for daisuke
+ * ビジターを初期化する。
*
- * @param rootModel
- * @param importedForeignKeys
+ * @param rootModel インポート先の{@link RootModel}
+ * @param importedForeignKeys インポートされた外部キーを格納する{@link Map}
*/
void initialize(RootModel rootModel, Map<String, ForeignKey> importedForeignKeys);
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/SqlEmitter.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/SqlEmitter.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/dialect/internal/SqlEmitter.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -25,7 +25,7 @@
import org.jiemamy.model.sql.SqlStatement;
/**
- * RootModelからSQLのリストを生成するインターフェイス。
+ * {@link RootModel}からSQLのリストを生成するエミッタインターフェイス。
*
* @author daisuke
*/
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/EventBrokerImpl.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/EventBrokerImpl.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/EventBrokerImpl.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -1,108 +1,108 @@
-/*
- * Copyright 2007-2009 Jiemamy Project and the Others.
- * Created on 2009/02/08
- *
- * This file is part of Jiemamy.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
- * either express or implied. See the License for the specific language
- * governing permissions and limitations under the License.
- */
-package org.jiemamy.internal;
-
-import java.util.List;
-import java.util.UUID;
-
-import org.apache.commons.lang.Validate;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-import org.jiemamy.DispatchStrategy;
-import org.jiemamy.EventBroker;
-import org.jiemamy.editcommand.Command;
-import org.jiemamy.editcommand.CommandListener;
-import org.jiemamy.model.JiemamyElement;
-import org.jiemamy.utils.CollectionsUtil;
-import org.jiemamy.utils.LogMarker;
-
-/**
- * EDITコマンドの実行を監視し、登録されている{@link CommandListener}にイベントを通知する。
- *
- * <p>{@link Command}が実行されたタイミングで、{@link #listeners}として保持している{@link CommandListener}の中で,
- * {@link Command#getTarget()}を監視する必要があるものにイベントを通知する。</p>
- *
- * @author shin1ogawa
- */
-public class EventBrokerImpl implements EventBroker {
-
- private static Logger logger = LoggerFactory.getLogger(EventBrokerImpl.class);
-
- private List<CommandListener> listeners = CollectionsUtil.newArrayList();
-
- private DispatchStrategy strategy = new DefaultDispatchStrategy();
-
-
- public void addListener(CommandListener listener) {
- assert listeners != null;
- Validate.notNull(listener);
- listeners.add(listener);
- logger.info(LogMarker.LIFECYCLE, "CommandListener is registered: " + listener.toString());
- }
-
- public void fireCommandProcessed(Command command) {
- assert listeners != null;
- logger.info(LogMarker.LIFECYCLE, "EventBroker is kicked enter: " + command.toString());
- logger.debug(LogMarker.LIFECYCLE, "target : " + command.getTarget());
- // java.util.ConcurrentModificationExceptionへの対策。
- List<CommandListener> listenersSnapthot = CollectionsUtil.newArrayList(listeners);
- for (CommandListener listener : listenersSnapthot) {
- if (strategy.needToDispatch(listener, command)) {
- listener.commandExecuted(command);
- logger.debug(LogMarker.LIFECYCLE, "Listener is kicked: " + listener.toString());
- }
- }
- logger.info(LogMarker.LIFECYCLE, "EventBroker is kicked exit: " + command.toString());
- }
-
- /**
- * (for debug) 登録されたリスナのリストを取得する。
- *
- * <p>このメソッドは、インスタンスの持つ{@link List}の防御コピーを返す。返される{@link List}を直接操作しても、
- * このオブジェクトの属性を操作することはできない。ただし、コレクションの要素はコピーされない、シャローコピーである。</p>
- *
- * @return the listeners
- */
- public List<CommandListener> getListeners() {
- assert listeners != null;
- return CollectionsUtil.newArrayList(listeners);
- }
-
- public void removeListener(CommandListener listener) {
- assert listeners != null;
- listeners.remove(listener);
- logger.info(LogMarker.LIFECYCLE, "CommandListener is unregistered: " + listener.toString());
- }
-
- public void setStrategy(DispatchStrategy strategy) {
- Validate.notNull(strategy);
- this.strategy = strategy;
- }
-
-
- private static class DefaultDispatchStrategy implements DispatchStrategy {
-
- public boolean needToDispatch(CommandListener listener, Command command) {
- UUID uuid = command.getTarget().getId();
- JiemamyElement targetModel = listener.getTargetModel();
- return ReferenceResolverImpl.isDescendFromElement(targetModel, uuid);
- }
- }
-}
+/*
+ * Copyright 2007-2009 Jiemamy Project and the Others.
+ * Created on 2009/02/08
+ *
+ * This file is part of Jiemamy.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+ * either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+package org.jiemamy.internal;
+
+import java.util.List;
+import java.util.UUID;
+
+import org.apache.commons.lang.Validate;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import org.jiemamy.DispatchStrategy;
+import org.jiemamy.EventBroker;
+import org.jiemamy.editcommand.Command;
+import org.jiemamy.editcommand.CommandListener;
+import org.jiemamy.model.JiemamyElement;
+import org.jiemamy.utils.CollectionsUtil;
+import org.jiemamy.utils.LogMarker;
+
+/**
+ * EDITコマンドの実行を監視し、登録されている{@link CommandListener}にイベントを通知する。
+ *
+ * <p>{@link Command}が実行されたタイミングで、{@link #listeners}として保持している{@link CommandListener}の中で,
+ * {@link Command#getTarget()}を監視する必要があるものにイベントを通知する。</p>
+ *
+ * @author shin1ogawa
+ */
+public class EventBrokerImpl implements EventBroker {
+
+ private static Logger logger = LoggerFactory.getLogger(EventBrokerImpl.class);
+
+ private List<CommandListener> listeners = CollectionsUtil.newArrayList();
+
+ private DispatchStrategy strategy = new DefaultDispatchStrategy();
+
+
+ public void addListener(CommandListener listener) {
+ assert listeners != null;
+ Validate.notNull(listener);
+ listeners.add(listener);
+ logger.info(LogMarker.LIFECYCLE, "CommandListener is registered: " + listener.toString());
+ }
+
+ public void fireCommandProcessed(Command command) {
+ assert listeners != null;
+ logger.info(LogMarker.LIFECYCLE, "EventBroker is kicked enter: " + command.toString());
+ logger.debug(LogMarker.LIFECYCLE, "target : " + command.getTarget());
+ // java.util.ConcurrentModificationExceptionへの対策。
+ List<CommandListener> listenersSnapthot = CollectionsUtil.newArrayList(listeners);
+ for (CommandListener listener : listenersSnapthot) {
+ if (strategy.needToDispatch(listener, command)) {
+ listener.commandExecuted(command);
+ logger.debug(LogMarker.LIFECYCLE, "Listener is kicked: " + listener.toString());
+ }
+ }
+ logger.info(LogMarker.LIFECYCLE, "EventBroker is kicked exit: " + command.toString());
+ }
+
+ /**
+ * (for debug) 登録されたリスナのリストを取得する。
+ *
+ * <p>このメソッドは、インスタンスの持つ{@link List}の防御コピーを返す。返される{@link List}を直接操作しても、
+ * このオブジェクトの属性を操作することはできない。ただし、コレクションの要素はコピーされない、シャローコピーである。</p>
+ *
+ * @return the listeners
+ */
+ public List<CommandListener> getListeners() {
+ assert listeners != null;
+ return CollectionsUtil.newArrayList(listeners);
+ }
+
+ public void removeListener(CommandListener listener) {
+ assert listeners != null;
+ listeners.remove(listener);
+ logger.info(LogMarker.LIFECYCLE, "CommandListener is unregistered: " + listener.toString());
+ }
+
+ public void setStrategy(DispatchStrategy strategy) {
+ Validate.notNull(strategy);
+ this.strategy = strategy;
+ }
+
+
+ private static class DefaultDispatchStrategy implements DispatchStrategy {
+
+ public boolean needToDispatch(CommandListener listener, Command command) {
+ UUID uuid = command.getTarget().getId();
+ JiemamyElement targetModel = listener.getTargetModel();
+ return ReferenceResolverImpl.isDescendFromElement(targetModel, uuid);
+ }
+ }
+}
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AbstractAddToCollectionCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AbstractAddToCollectionCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AbstractAddToCollectionCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -53,7 +53,7 @@
/**
* インスタンスを生成する。
*
- * @param eventBroker
+ * @param eventBroker イベント通知用{@link EventBroker}
* @param target 対象親モデル
* @param element 追加対象の子モデル要素
* @throws IllegalArgumentException 引数に{@code null}を与えた場合
@@ -71,7 +71,7 @@
/**
* インスタンスを生成する。
*
- * @param eventBroker
+ * @param eventBroker イベント通知用{@link EventBroker}
* @param target 対象親モデル
* @param element 追加対象の子モデル要素
* @param index 追加される位置インデックス
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AbstractCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AbstractCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AbstractCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -42,7 +42,7 @@
/**
* インスタンスを生成する。
*
- * @param eventBroker
+ * @param eventBroker イベント通知用{@link EventBroker}
* @throws IllegalArgumentException 引数に{@code null}を与えた場合
*/
public AbstractCommand(EventBroker eventBroker) {
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddAttributeCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddAttributeCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddAttributeCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -62,9 +62,9 @@
* インスタンスを生成する。
*
* @param eventBroker イベント通知用{@link EventBroker}
- * @param tableModel
- * @param index
- * @param attributeModel
+ * @param tableModel 追加されるテーブル
+ * @param index 追加位置をあらわすインデックス値
+ * @param attributeModel 追加するカラム
*/
public AddAttributeCommand(EventBroker eventBroker, TableModel tableModel, int index, AttributeModel attributeModel) {
super(eventBroker, tableModel, attributeModel, index);
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddColumnToColumnRefListCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddColumnToColumnRefListCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddColumnToColumnRefListCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -36,6 +36,7 @@
*/
public class AddColumnToColumnRefListCommand extends AbstractCommand {
+ /** 操作対象の{@link JiemamyElement} */
private final JiemamyElement target;
/** 追加対象のリスト */
@@ -52,7 +53,7 @@
* インスタンスを生成する。
*
* @param eventBroker イベント通知用{@link EventBroker}
- * @param target
+ * @param target 操作対象の{@link JiemamyElement}
* @param columnRefList 追加対象のリスト
* @param columnModel 追加されるカラム
*/
@@ -65,7 +66,7 @@
* インスタンスを生成する。
*
* @param eventBroker イベント通知用{@link EventBroker}
- * @param target
+ * @param target 操作対象の{@link JiemamyElement}
* @param columnRefList 追加対象のリスト
* @param columnModel 追加されるカラム
* @param index 追加位置インデックス
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddDataSetToRootCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddDataSetToRootCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddDataSetToRootCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -49,9 +49,9 @@
* インスタンスを生成する。
*
* @param eventBroker イベント通知用{@link EventBroker}
- * @param rootModel
- * @param dataSetModel
- * @param index
+ * @param rootModel 追加される{@link RootModel}
+ * @param dataSetModel 追加する{@link DataSetModel}
+ * @param index 追加位置をあらわすインデックス値
*/
public AddDataSetToRootCommand(EventBroker eventBroker, RootModel rootModel, DataSetModel dataSetModel, int index) {
super(eventBroker, rootModel, dataSetModel, index);
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddDomainToRootCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddDomainToRootCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddDomainToRootCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -49,9 +49,9 @@
* インスタンスを生成する。
*
* @param eventBroker イベント通知用{@link EventBroker}
- * @param rootModel
- * @param domainModel
- * @param index
+ * @param rootModel 追加される{@link RootModel}
+ * @param domainModel 追加する{@link DomainModel}
+ * @param index 追加位置をあらわすインデックス値
*/
public AddDomainToRootCommand(EventBroker eventBroker, RootModel rootModel, DomainModel domainModel, int index) {
super(eventBroker, rootModel, domainModel, index);
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddIndexColumnCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddIndexColumnCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddIndexColumnCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -52,7 +52,7 @@
*
* @param eventBroker イベント通知用{@link EventBroker}
* @param tableModel 追加される{@link TableModel}
- * @param index
+ * @param index 追加位置をあらわすインデックス値
* @param indexModel 追加する{@link DomainModel}
*/
public AddIndexColumnCommand(EventBroker eventBroker, IndexModel tableModel, int index, IndexColumnModel indexModel) {
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddIndexCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddIndexCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/AddIndexCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -51,7 +51,7 @@
*
* @param eventBroker イベント通知用{@link EventBroker}
* @param tableModel 追加される{@link TableModel}
- * @param index
+ * @param index 追加位置をあらわすインデックス値
* @param indexModel 追加する{@link DomainModel}
*/
public AddIndexCommand(EventBroker eventBroker, TableModel tableModel, int index, IndexModel indexModel) {
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveColumnFromColumnRefListCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveColumnFromColumnRefListCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveColumnFromColumnRefListCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -86,10 +86,10 @@
* インスタンスを生成する。
*
* @param eventBroker イベント通知用{@link EventBroker}
- * @param target
+ * @param target 操作対象の{@link JiemamyElement}
* @param columnRefList 削除対象のリスト
* @param columnModel 削除されるカラム
- * @param index
+ * @param index 追加位置をあらわすインデックス値
*/
public RemoveColumnFromColumnRefListCommand(EventBroker eventBroker, JiemamyElement target,
List<ColumnRef> columnRefList, ColumnModel columnModel, int index) {
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveDataSetFromRootCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveDataSetFromRootCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveDataSetFromRootCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -37,8 +37,8 @@
* インスタンスを生成する。
*
* @param eventBroker イベント通知用{@link EventBroker}
- * @param rootModel
- * @param dataSetModel
+ * @param rootModel 削除元の{@link RootModel}
+ * @param dataSetModel 削除される{@link DataSetModel}
* @throws IllegalArgumentException 引数に{@code null}を与えた場合
*/
public RemoveDataSetFromRootCommand(EventBroker eventBroker, RootModel rootModel, DataSetModel dataSetModel) {
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveDomainFromRootCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveDomainFromRootCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveDomainFromRootCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -37,8 +37,8 @@
* インスタンスを生成する。
*
* @param eventBroker イベント通知用{@link EventBroker}
- * @param rootModel
- * @param domainModel 削除されるドメイン
+ * @param rootModel 削除元の{@link RootModel}
+ * @param domainModel 削除される{@link DomainModel}
* @throws IllegalArgumentException 引数に{@code null}を与えた場合
*/
public RemoveDomainFromRootCommand(EventBroker eventBroker, RootModel rootModel, DomainModel domainModel) {
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveEntityFromRootCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveEntityFromRootCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveEntityFromRootCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -38,8 +38,8 @@
* インスタンスを生成する。
*
* @param eventBroker イベント通知用{@link EventBroker}
- * @param rootModel
- * @param entityModel 削除されるエンティティ
+ * @param rootModel 削除元の{@link RootModel}
+ * @param entityModel 削除される{@link EntityModel}
* @throws IllegalArgumentException 引数に{@code null}を与えた場合
*/
public RemoveEntityFromRootCommand(EventBroker eventBroker, RootModel rootModel, EntityModel entityModel) {
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveIndexColumnCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveIndexColumnCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveIndexColumnCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -22,12 +22,11 @@
import org.jiemamy.EventBroker;
import org.jiemamy.editcommand.Command;
-import org.jiemamy.model.entity.TableModel;
import org.jiemamy.model.index.IndexColumnModel;
import org.jiemamy.model.index.IndexModel;
/**
- * {@link TableModel}から{@link IndexModel}を削除するEDITコマンド。
+ * {@link IndexModel}から{@link IndexColumnModel}を削除するEDITコマンド。
*
* @see AddIndexCommand
* @author daisuke
@@ -38,8 +37,8 @@
* インスタンスを生成する。
*
* @param eventBroker イベント通知用{@link EventBroker}
- * @param indexModel
- * @param indexColumnModel 削除されるインデックス
+ * @param indexModel 削除元の{@link IndexModel}
+ * @param indexColumnModel 削除される{@link IndexColumnModel}
* @throws IllegalArgumentException 引数に{@code null}を与えた場合
*/
public RemoveIndexColumnCommand(EventBroker eventBroker, IndexModel indexModel, IndexColumnModel indexColumnModel) {
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveIndexCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveIndexCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/RemoveIndexCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -37,8 +37,8 @@
* インスタンスを生成する。
*
* @param eventBroker イベント通知用{@link EventBroker}
- * @param tableModel
- * @param indexModel 削除されるインデックス
+ * @param tableModel 削除元の{@link TableModel}
+ * @param indexModel 削除される{@link IndexModel}
* @throws IllegalArgumentException 引数に{@code null}を与えた場合
*/
public RemoveIndexCommand(EventBroker eventBroker, TableModel tableModel, IndexModel indexModel) {
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/SwapListElementCommand.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/SwapListElementCommand.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/editcommand/SwapListElementCommand.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -34,6 +34,7 @@
*/
public class SwapListElementCommand extends AbstractCommand {
+ /** 操作対象の{@link JiemamyElement} */
private final JiemamyElement target;
/** 変更対象のリスト */
@@ -50,7 +51,7 @@
* インスタンスを生成する。
*
* @param eventBroker イベント通知用{@link EventBroker}
- * @param target
+ * @param target 操作対象の{@link JiemamyElement}
* @param list 変更対象のリスト
* @param subjectIndex スワップ主体要素のインデックス
* @param objectIndex スワップ対象要素のインデックス
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/enhance/FactoryExtension.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/enhance/FactoryExtension.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/enhance/FactoryExtension.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -454,7 +454,7 @@
/**
* モデルインスタンスを生成する。
*
- * @param <T>
+ * @param <T> 生成するインスタンスの型
* @param jiemamy コンテキスト
* @param id モデルID
* @return モデルインスタンス
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/serializer/JiemamyDomBuilder.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/serializer/JiemamyDomBuilder.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/serializer/JiemamyDomBuilder.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -251,7 +251,7 @@
* DOM Documentを構築する。
*
* @return DOM Document
- * @throws ParserConfigurationException
+ * @throws ParserConfigurationException DocumentBuilderFactoryの設定異常
*/
public Document build() throws ParserConfigurationException {
DocumentBuilderFactory documentBuilderFactory = DocumentBuilderFactory.newInstance();
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/serializer/JiemamyDomParser.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/serializer/JiemamyDomParser.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/serializer/JiemamyDomParser.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -188,7 +188,7 @@
/**
* DOMを解析し、{@link RootModel}を生成する。
* @return 生成した{@link RootModel}
- * @throws SerializationException
+ * @throws SerializationException シリアライズに失敗した場合
*/
public RootModel parse() throws SerializationException {
RootModel rootModel = parseRoot();
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/serializer/JiemamyDomSerializer.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/serializer/JiemamyDomSerializer.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/internal/serializer/JiemamyDomSerializer.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -137,9 +137,9 @@
*
* @param in 入力
* @return DOMドキュメント
- * @throws ParserConfigurationException
+ * @throws ParserConfigurationException DocumentBuilderFactoryの設定異常
* @throws SAXException
- * @throws IOException
+ * @throws IOException 入出力エラーが発生した場合
*/
protected Document toDom(InputStream in) throws ParserConfigurationException, SAXException, IOException {
DocumentBuilder documentBuilder = DOCUMENT_BUILDER_FACTORY.newDocumentBuilder();
@@ -170,7 +170,7 @@
*
* @param rootModel 読み込む{@link RootModel}
* @return DOMドキュメント
- * @throws ParserConfigurationException
+ * @throws ParserConfigurationException DocumentBuilderFactoryの設定異常
*/
protected Document toDom(RootModel rootModel) throws ParserConfigurationException {
return new JiemamyDomBuilder(rootModel).build();
@@ -181,7 +181,7 @@
*
* @param document 読み込むDOMドキュメント
* @return {@link RootModel}
- * @throws SerializationException
+ * @throws SerializationException シリアライズに失敗した場合
*/
protected RootModel toRootModel(Document document) throws SerializationException {
return new JiemamyDomParser(jiemamy, document).parse();
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/DateUtil.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/DateUtil.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/DateUtil.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -31,6 +31,10 @@
*/
public class DateUtil {
+ /** Unix の「紀元年」 */
+ private static final int UNIX_EPOCH = 1970;
+
+
/**
* {@link java.util.Date}を{@link java.sql.Date}に変換する。
*
@@ -62,7 +66,7 @@
Calendar cal = Calendar.getInstance();
cal.setTime(date);
- cal.set(Calendar.YEAR, 1970);
+ cal.set(Calendar.YEAR, UNIX_EPOCH);
cal.set(Calendar.MONTH, Calendar.JANUARY);
cal.set(Calendar.DATE, 1);
return new java.sql.Time(cal.getTimeInMillis());
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/DriverUtil.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/DriverUtil.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/DriverUtil.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -50,7 +50,7 @@
*
* @param paths JARファイルを示すURLの配列
* @return Driverクラスのリスト
- * @throws IOException
+ * @throws IOException 入出力エラーが発生した場合
* @throws IllegalArgumentException 引数に{@code null}を与えた場合
* @throws IllegalArgumentException URIとして不適切なURLが引数に含まれていた場合
*/
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/EssentialQueue.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/EssentialQueue.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/EssentialQueue.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -26,7 +26,7 @@
* <p>{@link java.util.Queue}は不適切な継承を行っている為、
* Jiemamy Projectでは、こちらのインターフェイスを優先的に使用する。</p>
*
- * @param <E>
+ * @param <E> 要素の型
* @author daisuke
*/
public interface EssentialQueue<E> extends Iterable<E> {
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/ForEachUtil.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/ForEachUtil.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/ForEachUtil.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -135,7 +135,7 @@
*
* @param element 処理対象要素
* @return 引き続きacceptを継続する場合null、ループを終了する場合acceptが返すべき戻り値を返す。
- * @throws X
+ * @throws X ビジタが指定した例外が発生した場合
*/
R visit(T element) throws X;
}
@@ -164,7 +164,7 @@
* @param key 処理対象のキー
* @param value 処理対象の値
* @return 引き続きacceptを継続する場合null、ループを終了する場合acceptが返すべき戻り値を返す。
- * @throws X
+ * @throws X ビジタが指定した例外が発生した場合
*/
R visit(K key, V value) throws X;
}
@@ -172,7 +172,7 @@
/**
* {@link ResultSet}に対するビジター。
*
- * @param <T>
+ * @param <T> ビジターが受け取る要素の型
* @param <R> forEachが返すべき戻り値の型
* @param <X> visitメソッドが投げる可能性のある例外
* @author daisuke
@@ -191,7 +191,7 @@
*
* @param element 処理対象要素
* @return 引き続きacceptを継続する場合null、ループを終了する場合acceptが返すべき戻り値を返す。
- * @throws X
+ * @throws X ビジタが指定した例外が発生した場合
* @throws SQLException SQLの実行に失敗した場合
*/
R visit(T element) throws SQLException, X;
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/JmIOUtil.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/JmIOUtil.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/JmIOUtil.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -73,9 +73,12 @@
}
/**
- * TODO for daisuke
+ * 無条件にリソースを閉じる。
*
- * @param columnsResult
+ * <p>{@link IterableResult#close()} と等価であるが、例外を無視する。
+ * 主に finally 句内で使われることを想定している。</p>
+ *
+ * @param columnsResult 閉じる対象。nullでも、既にclose済みであっても構わない
*/
public static void closeQuietly(IterableResult<?> columnsResult) {
if (columnsResult != null) {
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/UUIDUtil.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/UUIDUtil.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/UUIDUtil.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -36,16 +36,16 @@
private static Logger logger = LoggerFactory.getLogger(UUIDUtil.class);
- /**
- * テスト用に使用するUUIDをランダムで発行するための便利メソッド。
- *
- * @param args 引数. 意味無し
- */
- public static void main(String[] args) {
- for (int i = 0; i < 5; i++) {
- System.out.println(UUID.randomUUID());
- }
- }
+// /**
+// * テスト用に使用するUUIDをランダムで発行するための便利メソッド。
+// *
+// * @param args 引数. 意味無し
+// */
+// public static void main(String[] args) {
+// for (int i = 0; i < 5; i++) {
+// System.out.println(UUID.randomUUID());
+// }
+// }
/**
* 文字列からUUIDを生成する。
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/model/TableUtil.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/model/TableUtil.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/model/TableUtil.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -49,8 +49,8 @@
* @param tableModel 対象のテーブル
* @param clazz 属性の型
* @return 属性
- * @throws TooManyElementsException
- * @throws ElementNotFoundException
+ * @throws TooManyElementsException 複数の属性が見つかった場合
+ * @throws ElementNotFoundException 属性が見つからなかった場合
* @throws IllegalArgumentException 引数に{@code null}を与えた場合
*/
public static <T extends AttributeModel>T getAttribute(TableModel tableModel, Class<T> clazz) {
@@ -65,8 +65,8 @@
* @param clazz 属性の型
* @param columnAttr カラム属性も検索対象とする場合は{@code true}、そうでない場合は{@code false}
* @return 属性
- * @throws TooManyElementsException
- * @throws ElementNotFoundException
+ * @throws TooManyElementsException 複数の属性が見つかった場合
+ * @throws ElementNotFoundException 属性が見つからなかった場合
* @throws IllegalArgumentException 引数に{@code null}を与えた場合
*/
public static <T extends AttributeModel>T getAttribute(TableModel tableModel, Class<T> clazz, boolean columnAttr) {
@@ -161,7 +161,7 @@
*
* @param tableModel 対象のテーブル
* @return 主キー制約
- * @throws TooManyElementsException
+ * @throws TooManyElementsException 複数の属性が見つかった場合
* @throws IllegalArgumentException 引数に{@code null}を与えた場合
*/
public static PrimaryKey getColumnPrimaryKey(TableModel tableModel) {
Modified: artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/swap/Swapper.java
===================================================================
--- artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/swap/Swapper.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/main/java/org/jiemamy/utils/swap/Swapper.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -133,7 +133,7 @@
}
/**
- * 引数{@code swapObj }に指定されたスワップ情報を元に RealObject をデシリアライズする。
+ * 引数{@code swapObj}に指定されたスワップ情報を元に RealObject をデシリアライズする。
*
* @param <T> 取得するスワップ済み RealObject のクラス
* @param swapObj スワップ位置情報を保持している{@link SwapObject }インスタンス
@@ -200,7 +200,7 @@
}
/**
- * 引数{@code obj }に指定された RealObject をスワップファイルへシリアライズする。
+ * 引数{@code obj}に指定された RealObject をスワップファイルへシリアライズする。
*
* <p>
* {@code Swapper#serialize(SwapObject, Serializable) }との違いは、<br>
@@ -218,7 +218,7 @@
}
/**
- * 引数{@code obj }に指定された RealObject をスワップファイルへシリアライズする。
+ * 引数{@code obj}に指定された RealObject をスワップファイルへシリアライズする。
*
* <p>
* RealObject がシリアライズされた位置、およびバイト長は引数{@code swapObj }の各フィールドに代入される。
Modified: artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/composer/importer/DatabaseImporterTest.java
===================================================================
--- artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/composer/importer/DatabaseImporterTest.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/composer/importer/DatabaseImporterTest.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -200,7 +200,7 @@
* インポートコンテキスト情報を生成する。
*
* @return インポートコンテキスト情報
- * @throws MalformedURLException
+ * @throws MalformedURLException コーディングミス
*/
private DatabaseImportConfig createConfig() throws MalformedURLException {
DefaultDatabaseImportConfig config = new DefaultDatabaseImportConfig();
Modified: artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/internal/test/TestModelBuilder2Test.java
===================================================================
--- artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/internal/test/TestModelBuilder2Test.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/internal/test/TestModelBuilder2Test.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -99,8 +99,7 @@
assertThat(user, is(notNullValue()));
assertThat(TableUtil.getPrimaryKey(user), is(mb.userPk));
assertThat(TableUtil.getPrimaryKey(user).getKeyColumns().size(), is(1));
- assertThat(TableUtil.getPrimaryKey(user).getKeyColumns().get(0).getReferenceId(), is(mb.userId
- .getId()));
+ assertThat(TableUtil.getPrimaryKey(user).getKeyColumns().get(0).getReferenceId(), is(mb.userId.getId()));
assertThat(TableUtil.getColumns(user).size(), is(2));
assertThat(TableUtil.getColumn(user, "ID"), is(mb.userId));
assertThat(TableUtil.getColumn(user, "NAME"), is(mb.userName));
@@ -110,8 +109,7 @@
assertThat(item, is(notNullValue()));
assertThat(TableUtil.getPrimaryKey(item), is(mb.itemPk));
assertThat(TableUtil.getPrimaryKey(item).getKeyColumns().size(), is(1));
- assertThat(TableUtil.getPrimaryKey(item).getKeyColumns().get(0).getReferenceId(), is(mb.itemId
- .getId()));
+ assertThat(TableUtil.getPrimaryKey(item).getKeyColumns().get(0).getReferenceId(), is(mb.itemId.getId()));
assertThat(TableUtil.getColumns(item).size(), is(3));
assertThat(TableUtil.getColumn(item, "ID"), is(mb.itemId));
assertThat(TableUtil.getColumn(item, "NAME"), is(mb.itemName));
@@ -122,8 +120,7 @@
assertThat(order, is(notNullValue()));
assertThat(TableUtil.getPrimaryKey(order), is(mb.orderPk));
assertThat(TableUtil.getPrimaryKey(order).getKeyColumns().size(), is(1));
- assertThat(TableUtil.getPrimaryKey(order).getKeyColumns().get(0).getReferenceId(), is(mb.orderId
- .getId()));
+ assertThat(TableUtil.getPrimaryKey(order).getKeyColumns().get(0).getReferenceId(), is(mb.orderId.getId()));
assertThat(TableUtil.getColumns(order).size(), is(3));
assertThat(TableUtil.getColumn(order, "ID"), is(mb.orderId));
assertThat(TableUtil.getColumn(order, "ORDER_DATE"), is(mb.orderDate));
@@ -134,8 +131,7 @@
assertThat(detail, is(notNullValue()));
assertThat(TableUtil.getPrimaryKey(detail), is(mb.detailPk));
assertThat(TableUtil.getPrimaryKey(detail).getKeyColumns().size(), is(1));
- assertThat(TableUtil.getPrimaryKey(detail).getKeyColumns().get(0).getReferenceId(),
- is(mb.detailId.getId()));
+ assertThat(TableUtil.getPrimaryKey(detail).getKeyColumns().get(0).getReferenceId(), is(mb.detailId.getId()));
assertThat(TableUtil.getColumns(detail).size(), is(4));
assertThat(TableUtil.getColumn(detail, "ID"), is(mb.detailId));
assertThat(TableUtil.getColumn(detail, "ORDER_ID"), is(mb.detailOrderId));
@@ -164,7 +160,7 @@
/**
* TODO for daisuke
*
- * @throws Exception
+ * @throws Exception 例外が発生した場合
*/
@Test
public void xstream() throws Exception {
Modified: artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/utils/ArrayEssentialStackTest.java
===================================================================
--- artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/utils/ArrayEssentialStackTest.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/utils/ArrayEssentialStackTest.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -96,7 +96,7 @@
/**
* {@link EssentialStack#reverse()}のテスト
*
- * @throws Exception
+ * @throws Exception 例外が発生した場合
*/
@Test
public void test03_reverseのテスト() throws Exception {
@@ -115,7 +115,7 @@
/**
* {@link EssentialStack#clear()}のテスト
*
- * @throws Exception
+ * @throws Exception 例外が発生した場合
*/
@Test
public void test04_clearのテスト() throws Exception {
@@ -131,7 +131,7 @@
/**
* {@link EssentialStack#insert(int, Object)}のテスト
*
- * @throws Exception
+ * @throws Exception 例外が発生した場合
*/
@Test
public void test05_insertのテスト() throws Exception {
@@ -147,7 +147,7 @@
/**
* {@link EssentialStack#isEmpty()}のテスト
*
- * @throws Exception
+ * @throws Exception 例外が発生した場合
*/
@Test
public void test06_isEmptyのテスト() throws Exception {
@@ -195,7 +195,7 @@
/**
* {@link EssentialStack#remove(int)}, {@link EssentialStack#remove(Object)}のテスト
*
- * @throws Exception
+ * @throws Exception 例外が発生した場合
*/
@Test
public void test08_removeのテスト() throws Exception {
@@ -235,7 +235,7 @@
/**
* コンストラクタにスタックを与えたスタックのテスト。
*
- * @throws Exception
+ * @throws Exception 例外が発生した場合
*/
public void test11_コンストラクタにスタックを与えたスタックのテスト() throws Exception {
EssentialStack<Element> source = new ArrayEssentialStack<Element>();
Modified: artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/utils/builder/TableBuilderTest.java
===================================================================
--- artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/utils/builder/TableBuilderTest.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-core/src/test/java/org/jiemamy/utils/builder/TableBuilderTest.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -86,7 +86,7 @@
/**
* ビルダを使ってみる。
*
- * @throws Exception
+ * @throws Exception 例外が発生した場合
*/
@Test
public void test01_ビルダを使ってみる() throws Exception {
Modified: artemis/trunk/jiemamy-dialect-postgresql/src/main/java/org/jiemamy/dialect/postgresql/adapter/PostgresObjectOption.java
===================================================================
--- artemis/trunk/jiemamy-dialect-postgresql/src/main/java/org/jiemamy/dialect/postgresql/adapter/PostgresObjectOption.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-dialect-postgresql/src/main/java/org/jiemamy/dialect/postgresql/adapter/PostgresObjectOption.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -19,23 +19,23 @@
package org.jiemamy.dialect.postgresql.adapter;
/**
- * TODO for daisuke
+ * PostgreSQLオブジェクトの共通設定項目インターフェイス。
*
* @author daisuke
*/
public interface PostgresObjectOption {
/**
- * TODO for daisuke
+ * テーブルスペース名を取得する。
*
- * @return
+ * @return テーブルスペース名
*/
String getTablespace();
/**
- * TODO for daisuke
+ * テーブルスペース名を設定する。
*
- * @param tablespace
+ * @param tablespace テーブルスペース名
*/
void setTablespace(String tablespace);
Modified: artemis/trunk/jiemamy-dialect-postgresql/src/main/java/org/jiemamy/dialect/postgresql/adapter/TableOption.java
===================================================================
--- artemis/trunk/jiemamy-dialect-postgresql/src/main/java/org/jiemamy/dialect/postgresql/adapter/TableOption.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-dialect-postgresql/src/main/java/org/jiemamy/dialect/postgresql/adapter/TableOption.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -28,16 +28,16 @@
public interface TableOption extends PostgresObjectOption {
/**
- * TODO for daisuke
+ * 一時テーブルに対してコミット時に行われるアクションを取得する。
*
- * @return
+ * @return 一時テーブルに対してコミット時に行われるアクション
*/
CommitAction getCommitAction();
/**
- * TODO for daisuke
+ * 一時テーブルかどうかを取得する。
*
- * @return
+ * @return 一時テーブルの場合は{@code true}、そうでない場合は{@code false}
*/
Boolean isTemporary();
Modified: artemis/trunk/jiemamy-view/src/main/java/org/jiemamy/internal/enhance/ViewFactoryExtensionEnhancer.java
===================================================================
--- artemis/trunk/jiemamy-view/src/main/java/org/jiemamy/internal/enhance/ViewFactoryExtensionEnhancer.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-view/src/main/java/org/jiemamy/internal/enhance/ViewFactoryExtensionEnhancer.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -59,7 +59,7 @@
/**
* {@link FactoryExtension}の拡張。
*
- * @param <T>
+ * @param <T> 生成したいインスタンスの型
* @author daisuke
*/
public static class ViewExtention<T> extends FactoryExtension<T> {
Modified: artemis/trunk/jiemamy-view/src/main/java/org/jiemamy/internal/enhance/ViewFactoryExtensionEnhancer2.java
===================================================================
--- artemis/trunk/jiemamy-view/src/main/java/org/jiemamy/internal/enhance/ViewFactoryExtensionEnhancer2.java 2009-04-03 11:21:32 UTC (rev 3085)
+++ artemis/trunk/jiemamy-view/src/main/java/org/jiemamy/internal/enhance/ViewFactoryExtensionEnhancer2.java 2009-04-03 11:22:20 UTC (rev 3086)
@@ -65,7 +65,7 @@
/**
* {@link FactoryExtension}の拡張。
*
- * @param <T>
+ * @param <T> 生成したいインスタンスの型
* @author daisuke
*/
public static class ViewExtention<T> extends FactoryExtension<T> {