From abbc33295d49d5bdbc8b83965f9ad9dbc652b480 Mon Sep 17 00:00:00 2001 From: Adelya <65678470+Adelechka@users.noreply.github.com> Date: Wed, 15 May 2024 09:53:36 +0300 Subject: [PATCH] feat: Feature/virtual proxy (#2955) * feature: Implement Virtual Proxy pattern #2940 * feature: Implement Virtual Proxy pattern #2940 * feature: Implement Virtual Proxy pattern #2940 * feature: Implement Virtual Proxy pattern #2940 * feature: Implement Virtual Proxy pattern #2940 * feature: Implement Virtual Proxy pattern, tests added * feature: Implement Virtual Proxy pattern, tests added * feature: Implement Virtual Proxy pattern, tests added * feature: Implement Virtual Proxy pattern, tests added * feature: Implement Virtual Proxy pattern, tests added * feature: Implement Virtual Proxy pattern iluwatar#2940 * feature: Implement Virtual Proxy pattern iluwatar#2940 * refactoring: proxy/pom.xml --- pom.xml | 1 + virtual-proxy/.gitignore | 59 ++++++++ virtual-proxy/README.md | 128 ++++++++++++++++++ virtual-proxy/etc/virtual.proxy.urm.png | Bin 0 -> 27483 bytes virtual-proxy/etc/virtual.proxy.urm.puml | 29 ++++ virtual-proxy/pom.xml | 73 ++++++++++ .../java/com/iluwatar/virtual/proxy/App.java | 42 ++++++ .../virtual/proxy/ExpensiveObject.java | 32 +++++ .../virtual/proxy/RealVideoObject.java | 50 +++++++ .../virtual/proxy/VideoObjectProxy.java | 44 ++++++ .../com/iluwatar/virtual/proxy/AppTest.java | 41 ++++++ .../virtual/proxy/RealVideoObjectTest.java | 53 ++++++++ .../virtual/proxy/VideoObjectProxyTest.java | 53 ++++++++ 13 files changed, 605 insertions(+) create mode 100644 virtual-proxy/.gitignore create mode 100644 virtual-proxy/README.md create mode 100644 virtual-proxy/etc/virtual.proxy.urm.png create mode 100644 virtual-proxy/etc/virtual.proxy.urm.puml create mode 100644 virtual-proxy/pom.xml create mode 100644 virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/App.java create mode 100644 virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/ExpensiveObject.java create mode 100644 virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/RealVideoObject.java create mode 100644 virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/VideoObjectProxy.java create mode 100644 virtual-proxy/src/test/java/com/iluwatar/virtual/proxy/AppTest.java create mode 100644 virtual-proxy/src/test/java/com/iluwatar/virtual/proxy/RealVideoObjectTest.java create mode 100644 virtual-proxy/src/test/java/com/iluwatar/virtual/proxy/VideoObjectProxyTest.java diff --git a/pom.xml b/pom.xml index ba42fd763..efa30a704 100644 --- a/pom.xml +++ b/pom.xml @@ -220,6 +220,7 @@ gateway slob server-session + virtual-proxy diff --git a/virtual-proxy/.gitignore b/virtual-proxy/.gitignore new file mode 100644 index 000000000..0d952be47 --- /dev/null +++ b/virtual-proxy/.gitignore @@ -0,0 +1,59 @@ +################## Eclipse ###################### +target +.metadata +.settings +.classpath +.project +*.class +tmp/ +*.tmp +*.bak +*~.nib +local.properties +.loadpath +.recommenders +.DS_Store + +####### Java annotation processor (APT) ######## +.factorypath + +################ Package Files ################## +*.jar +*.war +*.ear +*.swp +datanucleus.log +/bin/ +*.log +event-sourcing/Journal.json + +################## Checkstyle ################### +.checkstyle + +##################### STS ####################### +.apt_generated +.springBeans +.sts4-cache + +################# IntelliJ IDEA ################# +.idea +*.iws +*.iml +*.ipr + +################### NetBeans #################### +/nbproject/private/ +/nbbuild/ +/dist/ +/nbdist/ +/.nb-gradle/ +build/ +!**/src/main/**/build/ +!**/src/test/**/build/ + +#################### VS Code #################### +.vscode/ + +#################### Java Design Patterns ####### +etc/Java Design Patterns.urm.puml +serialized-entity/output.txt \ No newline at end of file diff --git a/virtual-proxy/README.md b/virtual-proxy/README.md new file mode 100644 index 000000000..10b856760 --- /dev/null +++ b/virtual-proxy/README.md @@ -0,0 +1,128 @@ +--- +title: Virtual Proxy +category: Structural +language: en +tag: + - Gang Of Four + - Decoupling +--- + +## Also known as + +Surrogate + +## Intent + +Provide a surrogate or placeholder for another object to control its creation and access, particularly when dealing with resource-intensive operations. + +## Explanation + +Real-world example + +> Consider an online video streaming platform where video objects are resource-intensive due to their large data size and required processing power. To efficiently manage resources, the system uses a virtual proxy to handle video objects. The virtual proxy defers the creation of actual video objects until they are explicitly required for playback, thus saving system resources and improving response times for users. + +In plain words + +> The virtual proxy pattern allows a representative class to stand in for another class to control access to it, particularly for resource-intensive operations. + +**Programmatic Example** + +Given our example of a video streaming service, here is how it might be implemented: + +First, we define an `ExpensiveObject` interface, which outlines the method for processing video. + +```java +public interface ExpensiveObject { + void process(); +} +``` + +Here’s the implementation of a `RealVideoObject` that represents an expensive-to-create video object. + +```java +@Getter +public class RealVideoObject implements ExpensiveObject { + private String videoData; + + public RealVideoObject() { + this.videoData = heavyInitialConfiguration(); + } + + private String heavyInitialConfiguration() { + System.out.println("Loading video data from the database or heavy computation..."); + return "Some loaded video data"; + } + + @Override + public void process() { + System.out.println("Playing video content with data: " + videoData); + } +} +``` + +The `VideoObjectProxy` serves as a stand-in for `RealExpensiveObject`. + +```java +@Getter +public class VideoObjectProxy implements ExpensiveObject { + private RealVideoObject realVideoObject; + + public void setRealVideoObject(RealVideoObject realVideoObject) { + this.realVideoObject = realVideoObject; + } + + @Override + public void process() { + if (realVideoObject == null) { + System.out.println("RealVideoObject is created on demand."); + realVideoObject = new RealVideoObject(); + } + realVideoObject.process(); + } +} +``` + +And here’s how the proxy is used in the system. + +``` +ExpensiveObject object = new VirtualProxy(); + object.process(); // The real object is created at this point + object.process(); // Uses the already created object +``` + +Program output: + +``` +Creating RealExpensiveObject only when it is needed. +Processing and playing video content... +Processing and playing video content... +``` + +## Class diagram + +![alt text](./etc/virtual.proxy.urm.png "Virtual Proxy pattern class diagram") + +## Applicability + +The virtual proxy pattern is useful when: + +* Object creation is resource-intensive, and not all instances are utilized immediately or ever. +* The performance of a system can be significantly improved by deferring the creation of objects until they are needed. +* There is a need for control over resource usage in systems dealing with large quantities of high-overhead objects. + +The virtual proxy pattern is typically used to: + +* Lazy Initialization: Create objects only when they are actually needed. +* Resource Management: Efficiently manage resources by creating heavy objects only on demand. +* Access Control: Include logic to check conditions before delegating calls to the actual object. +* Performance Optimization: Incorporate caching of results or states that are expensive to obtain or compute. +* Data Binding and Integration: Delay integration and binding processes until the data is actually needed. + +## Related patterns + +* [Proxy](https://github.com/iluwatar/java-design-patterns/tree/master/proxy) + +## Credits + +* [The Proxy Pattern in Java](https://www.baeldung.com/java-proxy-pattern) +* [What is the virtual proxy design pattern?](https://www.educative.io/answers/what-is-the-virtual-proxy-design-pattern) diff --git a/virtual-proxy/etc/virtual.proxy.urm.png b/virtual-proxy/etc/virtual.proxy.urm.png new file mode 100644 index 0000000000000000000000000000000000000000..1baf530bd2d83a6f2f0a05b21f69bbb589b42c97 GIT binary patch literal 27483 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 literal 0 HcmV?d00001 diff --git a/virtual-proxy/etc/virtual.proxy.urm.puml b/virtual-proxy/etc/virtual.proxy.urm.puml new file mode 100644 index 000000000..9d3cc5d5d --- /dev/null +++ b/virtual-proxy/etc/virtual.proxy.urm.puml @@ -0,0 +1,29 @@ +@startuml +class Client { + + main(args : String[]) {static} +} + +class RealVideoObject { + - videoData : String + + RealVideoObject() + + process() + + getVideoData() : String + - heavyInitialConfiguration() : void +} + +interface ExpensiveObject { + + process() {abstract} +} + +class VideoObjectProxy { + - realVideoObject : RealVideoObject + + VideoObjectProxy() + + process() + + setRealVideoObject(realVideoObject : RealVideoObject) : void + + getRealVideoObject() : RealVideoObject +} + +VideoObjectProxy --> "-realVideoObject" RealVideoObject +RealVideoObject ..|> ExpensiveObject +VideoObjectProxy ..|> ExpensiveObject +@enduml diff --git a/virtual-proxy/pom.xml b/virtual-proxy/pom.xml new file mode 100644 index 000000000..8f3fbc8f2 --- /dev/null +++ b/virtual-proxy/pom.xml @@ -0,0 +1,73 @@ + + + + + 4.0.0 + + com.iluwatar + java-design-patterns + 1.26.0-SNAPSHOT + + virtual-proxy + + + org.junit.jupiter + junit-jupiter-engine + test + + + org.mockito + mockito-core + test + + + junit + junit + test + + + + + + org.apache.maven.plugins + maven-assembly-plugin + + + + + + App + + + + + + + + + \ No newline at end of file diff --git a/virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/App.java b/virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/App.java new file mode 100644 index 000000000..b29d6fd99 --- /dev/null +++ b/virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/App.java @@ -0,0 +1,42 @@ +/* + * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt). + * + * The MIT License + * Copyright © 2014-2022 Ilkka Seppälä + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ + +package com.iluwatar.virtual.proxy; + +/** + * The main application class that sets up and runs the Virtual Proxy pattern demo. + */ +public class App { + /** + * The entry point of the application. + * + * @param args the command line arguments + */ + public static void main(String[] args) { + ExpensiveObject videoObject = new VideoObjectProxy(); + videoObject.process(); // The first call creates and plays the video + videoObject.process(); // Subsequent call uses the already created object + } +} \ No newline at end of file diff --git a/virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/ExpensiveObject.java b/virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/ExpensiveObject.java new file mode 100644 index 000000000..b5474e161 --- /dev/null +++ b/virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/ExpensiveObject.java @@ -0,0 +1,32 @@ +/* + * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt). + * + * The MIT License + * Copyright © 2014-2022 Ilkka Seppälä + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ +package com.iluwatar.virtual.proxy; + +/** + * Interface for expensive object and proxy object. + */ +public interface ExpensiveObject { + void process(); +} \ No newline at end of file diff --git a/virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/RealVideoObject.java b/virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/RealVideoObject.java new file mode 100644 index 000000000..dbdd4353f --- /dev/null +++ b/virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/RealVideoObject.java @@ -0,0 +1,50 @@ +/* + * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt). + * + * The MIT License + * Copyright © 2014-2022 Ilkka Seppälä + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ + +package com.iluwatar.virtual.proxy; + +import lombok.Getter; +import lombok.extern.slf4j.Slf4j; + +/** + * Represents a real video object that is expensive to create and manage. + */ +@Slf4j +@Getter +public class RealVideoObject implements ExpensiveObject { + + public RealVideoObject() { + heavyInitialConfiguration(); + } + + private void heavyInitialConfiguration() { + LOGGER.info("Loading initial video configurations..."); + } + + @Override + public void process() { + LOGGER.info("Processing and playing video content..."); + } +} \ No newline at end of file diff --git a/virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/VideoObjectProxy.java b/virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/VideoObjectProxy.java new file mode 100644 index 000000000..52b0e5f3f --- /dev/null +++ b/virtual-proxy/src/main/java/com/iluwatar/virtual/proxy/VideoObjectProxy.java @@ -0,0 +1,44 @@ +/* + * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt). + * + * The MIT License + * Copyright © 2014-2022 Ilkka Seppälä + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ + +package com.iluwatar.virtual.proxy; + +import lombok.Getter; + +/** + * A proxy class for the real video object, providing a layer of control over the object instantiation. + */ +@Getter +public class VideoObjectProxy implements ExpensiveObject { + private RealVideoObject realVideoObject; + + @Override + public void process() { + if (realVideoObject == null) { + realVideoObject = new RealVideoObject(); + } + realVideoObject.process(); + } +} \ No newline at end of file diff --git a/virtual-proxy/src/test/java/com/iluwatar/virtual/proxy/AppTest.java b/virtual-proxy/src/test/java/com/iluwatar/virtual/proxy/AppTest.java new file mode 100644 index 000000000..1f7cf8b6d --- /dev/null +++ b/virtual-proxy/src/test/java/com/iluwatar/virtual/proxy/AppTest.java @@ -0,0 +1,41 @@ +/* + * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt). + * + * The MIT License + * Copyright © 2014-2022 Ilkka Seppälä + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ + +package com.iluwatar.virtual.proxy; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertDoesNotThrow; + +/** + * Application test + */ +class AppTest { + + @Test + void shouldExecuteApplicationWithoutException() { + assertDoesNotThrow(() -> App.main(new String[]{})); + } +} \ No newline at end of file diff --git a/virtual-proxy/src/test/java/com/iluwatar/virtual/proxy/RealVideoObjectTest.java b/virtual-proxy/src/test/java/com/iluwatar/virtual/proxy/RealVideoObjectTest.java new file mode 100644 index 000000000..90f203556 --- /dev/null +++ b/virtual-proxy/src/test/java/com/iluwatar/virtual/proxy/RealVideoObjectTest.java @@ -0,0 +1,53 @@ +/* + * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt). + * + * The MIT License + * Copyright © 2014-2022 Ilkka Seppälä + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ +package com.iluwatar.virtual.proxy; +import static org.hamcrest.MatcherAssert.assertThat; +import static org.hamcrest.Matchers.instanceOf; +import static org.junit.jupiter.api.Assertions.assertDoesNotThrow; + +import org.junit.jupiter.api.Test; + +/** + * Tests for RealVideoObject. + */ +class RealVideoObjectTest { + + @Test + void testVideoObject() { + var videoObject = new RealVideoObject(); + assertThat(videoObject, instanceOf(ExpensiveObject.class)); + } + + @Test + public void constructorDoesNotThrowException() { + assertDoesNotThrow(RealVideoObject::new, "Constructor should not throw any exception"); + } + + @Test + public void processDoesNotThrowException() { + RealVideoObject realVideoObject = new RealVideoObject(); + assertDoesNotThrow(realVideoObject::process, "Process method should not throw any exception"); + } +} \ No newline at end of file diff --git a/virtual-proxy/src/test/java/com/iluwatar/virtual/proxy/VideoObjectProxyTest.java b/virtual-proxy/src/test/java/com/iluwatar/virtual/proxy/VideoObjectProxyTest.java new file mode 100644 index 000000000..2ede2c8a4 --- /dev/null +++ b/virtual-proxy/src/test/java/com/iluwatar/virtual/proxy/VideoObjectProxyTest.java @@ -0,0 +1,53 @@ +/* + * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt). + * + * The MIT License + * Copyright © 2014-2022 Ilkka Seppälä + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ + +package com.iluwatar.virtual.proxy; + +import static org.hamcrest.core.IsInstanceOf.instanceOf; +import static org.junit.jupiter.api.Assertions.*; + +import org.hamcrest.MatcherAssert; +import org.junit.jupiter.api.Test; + +/** + * Tests for VideoObjectProxy. + */ +public class VideoObjectProxyTest { + @Test + void shouldBeInstanceOfExpensiveObject() { + MatcherAssert.assertThat(new VideoObjectProxy(), instanceOf(ExpensiveObject.class)); + } + + @Test + void constructorDoesNotThrowException() { + assertDoesNotThrow(VideoObjectProxy::new, "Constructor should not throw any exception"); + } + + @Test + void processDoesNotThrowException() { + assertDoesNotThrow(() -> new VideoObjectProxy().process(), "Process method should not throw any exception"); + } + +} \ No newline at end of file