Merge pull request #158 from mendix/run/4337-newvaluechanged-actions

[RUN-4337] Add objectHasChangedMemberValue and memberHasChangedValue Java actions

Author: atennapel-mx

marketplace/release-notes/11.0.1.txt

@@ -1,3 +1,4 @@
 - The StringFromFile Java action now removes BOM from strings. (Ticket #242904)
 - We have upgraded the Guava dependency to 33.4.7. This also removes the dependency on the jsr305 version 3.0.2 dependency, which causes some code quality scanning tools to report issues.
-- We have added a warning about possible deadlocks to the commitInSeparateDatabaseTransaction Java action.
+- We have added a warning about possible deadlocks to the commitInSeparateDatabaseTransaction Java action.
+- We added the objectHasChangedMemberValue and memberHasChangedValue Java actions. These actions can be used to check if an object or member has a changed value that is different from the original value.

src/CommunityCommons/CommunityCommons.mpr

@@ -26,7 +26,6 @@
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
-import system.proxies.FileDocument;
 
 public class ORM {
 
@@ -46,6 +45,12 @@ public static boolean objectHasChanged(IMendixObject anyobject) {
 		return anyobject.isChanged();
 	}
 
+	/** Returns true if any member has a value other than its original value. */
+	public static boolean objectHasChangedMemberValue(IContext context, IMendixObject object) {
+		if (object == null) throw new IllegalArgumentException("The provided object is empty");
+		return object.hasChangedMemberValue(context);
+	}
+
 	/**
 	 * checks whether a certain member of an object has changed. If the objects itself is still new,
 	 * we consider to be changes as well.
@@ -65,6 +70,13 @@ public static boolean memberHasChanged(IContext context, IMendixObject item, Str
 		return item.getMember(member).isChanged() || item.getState() != ObjectState.NORMAL;
 	}
 
+	/** Check if the value of the member was changed to something other than its original value. */
+	public static boolean memberHasChangedValue(IContext context, IMendixObject item, String member) {
+		if (item == null) throw new IllegalArgumentException("The provided object is empty");
+		if (!item.hasMember(member)) throw new IllegalArgumentException("Unknown member: " + member);
+		return item.getMember(member).isValueChanged(context);
+	}
+
 	public static void deepClone(IContext c, IMendixObject source, IMendixObject target, String membersToSkip, String membersToKeep, String reverseAssociations, String excludeEntities, String excludeModules) throws CoreException {
 		List<String> toskip = Arrays.asList((membersToSkip + ",createdDate,changedDate").split(","));
 		List<String> tokeep = Arrays.asList((membersToKeep + ",System.owner,System.changedBy").split(","));

src/CommunityCommons/javasource/communitycommons/ORM.java

@@ -0,0 +1,56 @@
+// This file was generated by Mendix Studio Pro.
+//
+// WARNING: Only the following code will be retained when actions are regenerated:
+// - the import list
+// - the code between BEGIN USER CODE and END USER CODE
+// - the code between BEGIN EXTRA CODE and END EXTRA CODE
+// Other code you write will be lost the next time you deploy the project.
+// Special characters, e.g., é, ö, à, etc. are supported in comments.
+
+package communitycommons.actions;
+
+import com.mendix.systemwideinterfaces.core.IMendixObject;
+import communitycommons.ORM;
+import com.mendix.systemwideinterfaces.core.IContext;
+import com.mendix.systemwideinterfaces.core.UserAction;
+
+/**
+ * Check if the value of the member was changed to something other than its original value.
+ */
+public class memberHasChangedValue extends UserAction<java.lang.Boolean>
+{
+	private final IMendixObject item;
+	private final java.lang.String member;
+
+	public memberHasChangedValue(
+		IContext context,
+		IMendixObject _item,
+		java.lang.String _member
+	)
+	{
+		super(context);
+		this.item = _item;
+		this.member = _member;
+	}
+
+	@java.lang.Override
+	public java.lang.Boolean executeAction() throws Exception
+	{
+		// BEGIN USER CODE
+		return ORM.memberHasChangedValue(getContext(), item, member);
+		// END USER CODE
+	}
+
+	/**
+	 * Returns a string representation of this action
+	 * @return a string representation of this action
+	 */
+	@java.lang.Override
+	public java.lang.String toString()
+	{
+		return "memberHasChangedValue";
+	}
+
+	// BEGIN EXTRA CODE
+	// END EXTRA CODE
+}

src/CommunityCommons/javasource/communitycommons/actions/memberHasChangedValue.java

@@ -0,0 +1,53 @@
+// This file was generated by Mendix Studio Pro.
+//
+// WARNING: Only the following code will be retained when actions are regenerated:
+// - the import list
+// - the code between BEGIN USER CODE and END USER CODE
+// - the code between BEGIN EXTRA CODE and END EXTRA CODE
+// Other code you write will be lost the next time you deploy the project.
+// Special characters, e.g., é, ö, à, etc. are supported in comments.
+
+package communitycommons.actions;
+
+import com.mendix.systemwideinterfaces.core.IMendixObject;
+import communitycommons.ORM;
+import com.mendix.systemwideinterfaces.core.IContext;
+import com.mendix.systemwideinterfaces.core.UserAction;
+
+/**
+ * Returns true if any member has a value other than its original value.
+ */
+public class objectHasChangedMemberValue extends UserAction<java.lang.Boolean>
+{
+	private final IMendixObject item;
+
+	public objectHasChangedMemberValue(
+		IContext context,
+		IMendixObject _item
+	)
+	{
+		super(context);
+		this.item = _item;
+	}
+
+	@java.lang.Override
+	public java.lang.Boolean executeAction() throws Exception
+	{
+		// BEGIN USER CODE
+		return ORM.objectHasChangedMemberValue(getContext(), item);
+		// END USER CODE
+	}
+
+	/**
+	 * Returns a string representation of this action
+	 * @return a string representation of this action
+	 */
+	@java.lang.Override
+	public java.lang.String toString()
+	{
+		return "objectHasChangedMemberValue";
+	}
+
+	// BEGIN EXTRA CODE
+	// END EXTRA CODE
+}