Five finger exercise -- a more complex cmdlet in C++/CLI
Moving on from the previous post, porting the main cmdlet example to C++/CLI -- along with adapting it to later PowerShell behaviour (the original code assumed that the provider path resolution would not throw on non-existent items, so some exception handling needed to be added ahead of the fallback check for the file existing), making it pass the MSFT FxCop rules for PowerShell (fixing the verb, class and namespace in the main), and allowing it to be localized (through resource files as well as through the PowerShell look-up mechanism), and so forth...
I let Visual Studio generate the class outline, so there's a slightly pointless split into header file and implementation, but that aside, it's only the little bits of baroque syntax that really distinguish it from the C# equivalent. So perhaps I shouldn't forget about the language quite so much.
#pragma once | |
using namespace System; | |
using namespace System::IO; | |
using namespace System::Management::Automation; | |
namespace PSBook { namespace Commands | |
{ | |
[Cmdlet(VerbsCommon::Set, "FileTouchTime", DefaultParameterSetName = "Path", SupportsShouldProcess = true, ConfirmImpact = ConfirmImpact::Medium)] | |
public ref class SetFileTouchTimeCommand : | |
public PSCmdlet | |
{ | |
public: | |
SetFileTouchTimeCommand(void); | |
[Parameter(ParameterSetName = "Path", Mandatory = true, Position = 1, | |
ValueFromPipeline = true, ValueFromPipelineByPropertyName = true)] | |
property String ^ Path; | |
[Parameter(ParameterSetName = "FileInfo", Mandatory = true, Position = 1, | |
ValueFromPipeline = true)] | |
property FileInfo ^ FileInfo; | |
[Parameter] | |
property DateTime Date; | |
protected: | |
virtual void ProcessRecord(void) override; | |
private: | |
void TouchFile(System::IO::FileInfo ^ fileInfo); | |
void HandleFileNotFound(String ^ path, Exception ^ exception); | |
Resources::ResourceManager ^ rm; | |
}; | |
}} | |
#include "TouchFileCommand.h" | |
namespace PSBook { namespace Commands | |
{ | |
SetFileTouchTimeCommand::SetFileTouchTimeCommand(void) | |
{ | |
Date = DateTime::Now; | |
rm = gcnew Resources::ResourceManager(L"PowershellCpp.Messages", GetType()->Assembly); | |
} | |
void SetFileTouchTimeCommand::ProcessRecord(void) | |
{ | |
if (FileInfo != nullptr) | |
{ | |
TouchFile(FileInfo); | |
} | |
ProviderInfo ^ provider = nullptr; | |
try | |
{ | |
auto resolvedPaths = GetResolvedProviderPathFromPSPath(Path, provider); | |
for each (String ^ path in resolvedPaths) | |
{ | |
if (File::Exists(path)) | |
{ | |
auto info = gcnew System::IO::FileInfo(path); | |
TouchFile(info); | |
} | |
else | |
{ | |
HandleFileNotFound(path, nullptr); | |
return; | |
} | |
} | |
} | |
catch (ItemNotFoundException ^ nf) | |
{ | |
HandleFileNotFound(Path, nf); | |
} | |
} | |
void SetFileTouchTimeCommand::HandleFileNotFound(String ^ path, Exception ^ exception) | |
{ | |
auto message = String::Format( | |
System::Globalization::CultureInfo::CurrentCulture, | |
rm->GetString("FileNotFound"), path); | |
auto ae = gcnew ArgumentException(message, exception); | |
auto error = gcnew ErrorRecord(ae, "FileNotFound", ErrorCategory::ObjectNotFound, path); | |
WriteError(error); | |
} | |
void SetFileTouchTimeCommand::TouchFile(System::IO::FileInfo ^ fileInfo) | |
{ | |
if(ShouldProcess(fileInfo->FullName, String::Format( | |
System::Globalization::CultureInfo::CurrentCulture, | |
rm->GetString("ConfirmString"), Date))) | |
{ | |
try | |
{ | |
fileInfo->LastWriteTime = Date; | |
} | |
catch (UnauthorizedAccessException ^ uae) | |
{ | |
auto error = gcnew ErrorRecord(uae, "UnauthorizedFileAccess", ErrorCategory::PermissionDenied, fileInfo ->FullName); | |
auto detail = String::Format( | |
System::Globalization::CultureInfo::CurrentCulture, | |
rm->GetString("AccessDenied"), | |
fileInfo->FullName); | |
error->ErrorDetails = gcnew ErrorDetails(detail); | |
WriteError(error); | |
return; | |
} | |
WriteObject(fileInfo); | |
} | |
} | |
}} |
<?xml version="1.0" encoding="utf-8"?> | |
<root> | |
<!-- | |
Microsoft ResX Schema | |
Version 2.0 | |
The primary goals of this format is to allow a simple XML format | |
that is mostly human readable. The generation and parsing of the | |
various data types are done through the TypeConverter classes | |
associated with the data types. | |
Example: | |
... ado.net/XML headers & schema ... | |
<resheader name="resmimetype">text/microsoft-resx</resheader> | |
<resheader name="version">2.0</resheader> | |
<resheader name="reader">System.Resources.ResXResourceReader, System.Windows.Forms, ...</resheader> | |
<resheader name="writer">System.Resources.ResXResourceWriter, System.Windows.Forms, ...</resheader> | |
<data name="Name1"><value>this is my long string</value><comment>this is a comment</comment></data> | |
<data name="Color1" type="System.Drawing.Color, System.Drawing">Blue</data> | |
<data name="Bitmap1" mimetype="application/x-microsoft.net.object.binary.base64"> | |
<value>[base64 mime encoded serialized .NET Framework object]</value> | |
</data> | |
<data name="Icon1" type="System.Drawing.Icon, System.Drawing" mimetype="application/x-microsoft.net.object.bytearray.base64"> | |
<value>[base64 mime encoded string representing a byte array form of the .NET Framework object]</value> | |
<comment>This is a comment</comment> | |
</data> | |
There are any number of "resheader" rows that contain simple | |
name/value pairs. | |
Each data row contains a name, and value. The row also contains a | |
type or mimetype. Type corresponds to a .NET class that support | |
text/value conversion through the TypeConverter architecture. | |
Classes that don't support this are serialized and stored with the | |
mimetype set. | |
The mimetype is used for serialized objects, and tells the | |
ResXResourceReader how to depersist the object. This is currently not | |
extensible. For a given mimetype the value must be set accordingly: | |
Note - application/x-microsoft.net.object.binary.base64 is the format | |
that the ResXResourceWriter will generate, however the reader can | |
read any of the formats listed below. | |
mimetype: application/x-microsoft.net.object.binary.base64 | |
value : The object must be serialized with | |
: System.Runtime.Serialization.Formatters.Binary.BinaryFormatter | |
: and then encoded with base64 encoding. | |
mimetype: application/x-microsoft.net.object.soap.base64 | |
value : The object must be serialized with | |
: System.Runtime.Serialization.Formatters.Soap.SoapFormatter | |
: and then encoded with base64 encoding. | |
mimetype: application/x-microsoft.net.object.bytearray.base64 | |
value : The object must be serialized into a byte array | |
: using a System.ComponentModel.TypeConverter | |
: and then encoded with base64 encoding. | |
--> | |
<xsd:schema id="root" xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"> | |
<xsd:import namespace="http://www.w3.org/XML/1998/namespace" /> | |
<xsd:element name="root" msdata:IsDataSet="true"> | |
<xsd:complexType> | |
<xsd:choice maxOccurs="unbounded"> | |
<xsd:element name="metadata"> | |
<xsd:complexType> | |
<xsd:sequence> | |
<xsd:element name="value" type="xsd:string" minOccurs="0" /> | |
</xsd:sequence> | |
<xsd:attribute name="name" use="required" type="xsd:string" /> | |
<xsd:attribute name="type" type="xsd:string" /> | |
<xsd:attribute name="mimetype" type="xsd:string" /> | |
<xsd:attribute ref="xml:space" /> | |
</xsd:complexType> | |
</xsd:element> | |
<xsd:element name="assembly"> | |
<xsd:complexType> | |
<xsd:attribute name="alias" type="xsd:string" /> | |
<xsd:attribute name="name" type="xsd:string" /> | |
</xsd:complexType> | |
</xsd:element> | |
<xsd:element name="data"> | |
<xsd:complexType> | |
<xsd:sequence> | |
<xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" /> | |
<xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" /> | |
</xsd:sequence> | |
<xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" /> | |
<xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" /> | |
<xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" /> | |
<xsd:attribute ref="xml:space" /> | |
</xsd:complexType> | |
</xsd:element> | |
<xsd:element name="resheader"> | |
<xsd:complexType> | |
<xsd:sequence> | |
<xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" /> | |
</xsd:sequence> | |
<xsd:attribute name="name" type="xsd:string" use="required" /> | |
</xsd:complexType> | |
</xsd:element> | |
</xsd:choice> | |
</xsd:complexType> | |
</xsd:element> | |
</xsd:schema> | |
<resheader name="resmimetype"> | |
<value>text/microsoft-resx</value> | |
</resheader> | |
<resheader name="version"> | |
<value>2.0</value> | |
</resheader> | |
<resheader name="reader"> | |
<value>System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value> | |
</resheader> | |
<resheader name="writer"> | |
<value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value> | |
</resheader> | |
<data name="AccessDenied" xml:space="preserve"> | |
<value>Unable to touch file '{0}'; check whether it is read-only or otherwise inaccessible to you.</value> | |
</data> | |
<data name="ConfirmString" xml:space="preserve"> | |
<value>Touch file last write time to {0}</value> | |
</data> | |
<data name="FileNotFound" xml:space="preserve"> | |
<value>File '{0}' was not found</value> | |
</data> | |
</root> |
No comments :
Post a Comment